在Symfony项目中,服务容器是用来管理对象依赖与实例化的核心组件。当我们写好一个处理业务逻辑的类,希望它能被控制器或其他服务方便调用时,就需要把它注册为容器中的自定义服务。这样容器会负责创建对象并注入所需依赖。

什么是服务容器与自定义服务
服务容器是一个专门存放对象的盒子,里面的每个对象叫作服务。自定义服务就是我们自己写的类,通过配置告诉Symfony由容器来管理。比如下面这个简单的日志处理类:
<?php
namespace AppService;
class LoggerService
{
public function log(string $message): void
{
// 简单输出日志信息
echo $message . PHP_EOL;
}
}
使用YAML文件注册服务
在Symfony里,最常见的方式是在config/services.yaml中声明自定义服务。你可以手动指定类路径并起一个服务id。
# config/services.yaml
services:
AppServiceLoggerService:
autowire: true
autoconfigure: true
public: false
上面的配置中,autowire开启自动依赖注入,autoconfigure让服务自动应用已有配置。如果不写资源批量加载,也可以单独用id方式写:
services:
app.logger:
class: AppServiceLoggerService
autowire: true
在控制器中使用自定义服务
注册完成后,在控制器里通过类型提示就能拿到实例,容器会自动帮我们创建并传入。
<?php
namespace AppController;
use AppServiceLoggerService;
use SymfonyBundleFrameworkBundleControllerAbstractController;
use SymfonyComponentHttpFoundationResponse;
class DemoController extends AbstractController
{
public function index(LoggerService $logger): Response
{
$logger->log('这是来自自定义服务的信息');
return new Response('ok');
}
}
带依赖的自定义服务注册
如果自定义服务本身需要别的服务,比如发邮件服务依赖日志服务,直接写构造器即可,容器会按顺序注入。
<?php
namespace AppService;
class MailService
{
private LoggerService $logger;
public function __construct(LoggerService $logger)
{
$this->logger = $logger;
}
public function send(): void
{
$this->logger->log('邮件已发送');
}
}
对应YAML不需要额外写参数,autowire会自动处理:
services:
AppServiceMailService:
autowire: true
通过PHP配置注册
除了YAML,也可以使用PHP格式的容器配置,逻辑更程序化。
<?php
use AppServiceLoggerService;
use SymfonyComponentDependencyInjectionContainerBuilder;
return function (ContainerBuilder $container) {
$container->register('app.logger', LoggerService::class)
->setAutowired(true)
->setPublic(false);
};
小结
注册自定义服务容器的关键就是让Symfony知道类的位置并交给容器管理。日常开发建议开启autowire,减少手工绑定。遇到复杂依赖时,用构造器注入保持代码清晰。掌握这些,你就能灵活组织自己的业务服务。