解决serversideup/docker-php中S6调度器无法找到Artisan文件的问题

在使用serversideup/docker-php项目的PHP 8.3 FPM Apache镜像时，用户报告了一个关于Laravel调度器工作异常的问题。这个问题特别出现在从V2版本升级到V3版本后，调度器虽然能够执行，但无法正确启动新的Artisan命令。

问题现象

当通过S6 overlay运行Laravel调度器时，系统会报错"Could not open input file: artisan"。这表明调度器无法定位到Artisan文件，尽管该文件确实存在于容器中。

问题根源

经过深入分析，发现问题的核心在于工作目录的变更。在V2版本的镜像中，调度器命令执行前会先切换到项目目录(/var/www/html)，而在V3版本中这个目录切换被移除了。

具体表现为：

• V2版本执行路径：cd /var/www/html && php /var/www/html/artisan schedule:work
• V3版本执行路径：php /var/www/html/artisan schedule:work

解决方案

开发者提供了两种可行的解决方案：

方案一：显式定义ARTISAN_BINARY常量

在Laravel应用的Console/Kernel.php文件中，可以通过构造函数显式定义ARTISAN_BINARY常量：

public function __construct(
    \Illuminate\Contracts\Foundation\Application $app,
    \Illuminate\Contracts\Events\Dispatcher $events
) {
    if (! defined('ARTISAN_BINARY')) {
        define('ARTISAN_BINARY', '/var/www/html/artisan');
    }

    parent::__construct($app, $events);
}

这种方法强制指定了Artisan文件的绝对路径，确保无论从哪个目录执行都能找到正确的文件。

方案二：恢复工作目录切换

更简单的解决方案是在S6服务脚本中恢复工作目录的切换：

RUN mkdir -p /etc/s6-overlay/s6-rc.d/laravel-schedule ; \
    echo "#!/usr/bin/bash" >> /etc/s6-overlay/s6-rc.d/laravel-schedule/run ; \
    echo "cd /var/www/html && php /var/www/html/artisan schedule:work --run-output-file=/var/www/html/schedule.log" >> /etc/s6-overlay/s6-rc.d/laravel-schedule/run ; \
    echo "longrun" >> /etc/s6-overlay/s6-rc.d/laravel-schedule/type ; \
    echo "50-laravel-automations" >> /etc/s6-overlay/s6-rc.d/laravel-schedule/dependencies ; \
    touch /etc/s6-overlay/s6-rc.d/user/contents.d/laravel-schedule

最佳实践建议

1. 权限管理：确保复制文件时使用正确的权限，推荐使用--chown=www-data:www-data参数

2. S6服务优化：考虑使用docker-php-serversideup-s6-init来管理自定义的S6服务，这能提供更好的集成和可靠性

3. 路径处理：在容器环境中，尽量使用绝对路径来引用关键文件，避免因工作目录变化导致的问题

4. 版本升级检查：在升级Docker镜像版本时，应仔细检查启动脚本和工作目录相关的变更

总结

这个问题展示了容器环境中工作目录管理的重要性。虽然简单的解决方案是恢复目录切换，但从长期维护角度看，使用绝对路径或定义常量是更健壮的解决方案。这也提醒开发者在升级基础镜像时，需要关注这些看似微小但影响重大的变更。