Zend Framework 3按日志等级拆分写入专属日志文件的配置问题
问题根源
你现在的代码踩了两个核心认知误区:
Logger::addWriter()方法的第二个入参是 Writer 的执行优先级(数值越大越先触发处理),完全不参与日志等级的判断过滤。所以你之前传的6、7、3不会对日志做任何拦截,三个Writer都会接收到所有传入Logger的日志,自然每级日志都会被同时写到三个文件里。- Zend Log 的日志等级过滤逻辑,必须绑定在每个Writer自身上,通过给Writer添加独立过滤器实现,不能通过addWriter的参数传入。
Zend Log 内置的日志等级常量值你之前是记对的:
Logger::DEBUG = 7Logger::INFO = 6Logger::ERR = 3
只是你把这些值的传参位置搞错了。
修正实现方式
步骤1:引入日志过滤器类
在HomeControllerFactory.php顶部新增过滤器的类引用:use Zend\Log\Filter;
步骤2:给每个Writer绑定精确等级的过滤器
注意:Priority过滤器的默认比较规则是“大于等于阈值”,因为Zend Log的常量设计是数值越小日志越严重,如果用默认规则,会出现低严重度的日志(比如debug)被所有Writer放行的串写问题,所以必须指定精确匹配的比较符。
修正后的完整工厂代码
<?php namespace Application\Controller; use Zend\ServiceManager\Factory\FactoryInterface; use Interop\Container\ContainerInterface; use Zend\Log\Logger; use Zend\Log\Writer; use Zend\Log\Filter; // 新增过滤器引用 class HomeControllerFactory implements FactoryInterface { public function __invoke(ContainerInterface $container, $requestedName, array $options = null) { $serviceManager = $container->get('ServiceManager'); $logger = $container->get(Logger::class); // 初始化三个文件写入器 $infoWriter = new Writer\Stream('C:\log\info.log'); // 给infoWriter加过滤器:只放行INFO等级的日志 $infoWriter->addFilter(new Filter\Priority( Logger::INFO, '=' // 精确匹配,替换默认的大于等于规则 )); $debugWriter = new Writer\Stream('C:\log\debug.log'); $debugWriter->addFilter(new Filter\Priority( Logger::DEBUG, '=' )); $errorWriter = new Writer\Stream('C:\log\error.log'); $errorWriter->addFilter(new Filter\Priority( Logger::ERR, '=' )); // 绑定Writer到Logger,第二个参数仅设置执行顺序,无过滤作用 $logger->addWriter($infoWriter, 1); $logger->addWriter($debugWriter, 1); $logger->addWriter($errorWriter, 1); return new HomeController($serviceManager, $logger); } }
补充说明
- 如果后续需要调整日志归集规则,比如希望
error.log能收录所有严重度高于等于ERR的日志(包括EMERG、ALERT、CRIT、ERR),可以把errorWriter的过滤器比较符改成<=,就能自动过滤掉所有严重度低于ERR的日志,不用改其他逻辑。 - 提前确认
C:\log目录存在,且运行PHP服务的账号有目录写入权限,否则Writer初始化时会抛出流不可用的异常。 - 因为从容器里获取的Logger是全局单例,要注意不要在工厂里重复给同一个Logger实例绑定同一个Writer,不然后续请求触发的时候,会因为重复绑定Writer导致同一条日志被重复写进文件。可以在绑定Writer之前先判断当前Logger是否已经加过对应Writer,避免重复追加。
- 这种在控制器工厂里手动初始化Writer的写法可以解决当前问题,但后续如果有多个控制器需要用Logger,会出现重复绑定Writer的冗余逻辑,后续可以把Writer的绑定逻辑移到全局配置里,由服务管理器统一初始化Logger实例,不用每个工厂重复写代码。
内容的提问来源于stack exchange,提问作者Sreejith Pm
相关产品推荐
相关产品推荐

