通过服务容器的singleton方法可确保Laravel应用中服务全局唯一，适用于数据库连接等需统一管理的场景。1、使用artisan创建PaymentProcessor服务类并定义逻辑；2、在AppServiceProvider中用singleton绑定该类，保证每次解析返回同一实例；3、通过接口与实现分离，将PaymentInterface绑定到PaymentProcessor单例，提升解耦与可测试性；4、控制器中通过类型提示自动注入该服务；5、亦可使用instance方法手动注册已创建实例，实现更精细的实例控制。
如果您希望在 Laravel 应用中确保某个服务在整个请求生命周期内仅被实例化一次，并全局共享同一个实例，可以通过服务容器的单例绑定机制实现。这种方式适用于数据库连接、日志处理器等需要统一管理实例的对象。
本文运行环境：MacBook Pro，macOS Sonoma
一、使用 bind 和 singleton 方法注册单例服务
通过 Laravel 服务容器的 singleton 方法，可以将一个类始终以同一个实例的形式注入到应用中，无论多少次解析该服务，返回的都是最初创建的那个对象。
1、打开终端并进入项目根目录，执行 Artisan 命令创建一个服务类：
php artisan make:service PaymentProcessor
2、在 app/Services 目录下创建名为 PaymentProcessor.php 的文件，并添加基本逻辑：
<?php
namespace App\Services;
class PaymentProcessor
{
private $transactionId;
public function __construct()
{
$this->transactionId = uniqid('txn_');
}
public function getTransactionId(): string
{
return $this->transactionId;
}
}
3、在 AppServiceProvider 的 register 方法中进行单例绑定：
use App\Services\PaymentProcessor;
public function register()
{
$this->app->singleton(PaymentProcessor::class, function ($app) {
return new PaymentProcessor();
});
}
二、通过自动发现与接口绑定实现解耦的单例服务
利用接口与具体实现类之间的绑定关系，可以在不修改调用代码的前提下替换实现，同时保持单例特性，提升应用可测试性和扩展性。
1、创建一个接口文件 PaymentInterface.php 在 app/Contracts 目录下：
<?php
namespace App\Contracts;
interface PaymentInterface
{
public function process(float $amount): array;
}
2、让 PaymentProcessor 实现该接口：
use App\Contracts\PaymentInterface;
class PaymentProcessor implements PaymentInterface
{
private $transactionId;
public function __construct()
{
$this->transactionId = uniqid('txn_');
}
public function getTransactionId(): string
{
return $this->transactionId;
}
public function process(float $amount): array
{
return [
'success' => true,
'amount' => $amount,
'transaction_id' => $this->getTransactionId()
];
}
}
3、在 AppServiceProvider 中注册接口到单例实现的映射：
$this->app->singleton(
PaymentInterface::class,
PaymentProcessor::class
);
4、在控制器或其他类中通过类型提示自动注入：
use App\Contracts\PaymentInterface;
class PaymentController extends Controller
{
protected $payment;
public function __construct(PaymentInterface $payment)
{
$this->payment = $payment;
}
public function pay()
{
dd($this->payment->process(99.99));
}
}
三、使用即时单例（Instance Binding）手动管理实例
当需要完全控制对象实例化时机时，可使用 instance 方法将一个已创建的对象直接绑定到服务容器中，后续所有解析都将返回此实例。
1、在 AppServiceProvider 的 register 方法中手动创建实例并绑定：
use App\Services\PaymentProcessor; $processor = new PaymentProcessor(); $this->app->instance(PaymentProcessor::class, $processor);
2、该方式适合在配置加载后根据条件决定是否复用已有实例的场景，例如结合缓存或配置判断：
if (config('services.payment.singleton')) {
$this->app->instance(PaymentProcessor::class, new PaymentProcessor());
}
