ThinkPHP在Docker中如何快速部署_容器化环境搭建与镜像构建-ThinkPHP-PHP中文网

thinkphp容器启动失败主因是runtime目录权限问题，需构建时设www-data属主、运行时指定用户、分离挂载并校验php-fpm配置；依赖应分层安装且禁用dev包；nginx须正确传递path_info；扩展需统一cli/fpm配置；日志排查优先于前端观察。

thinkphp在docker中如何快速部署_容器化环境搭建与镜像构建

容器里跑 ThinkPHP 最常卡在这一步：日志、缓存、模板编译全写不进 runtime 目录。根本不是代码问题，是容器用户和宿主机权限没对齐。

实操建议：

构建镜像时用 RUN mkdir -p /var/www/runtime && chown -R www-data:www-data /var/www/runtime，别等运行时再改
如果用 docker run 启动，加 -u www-data 参数，确保 PHP 进程以正确用户身份运行
宿主机挂载 runtime 目录时，避免直接挂载整个项目目录（如 -v ./app:/var/www），改用只读挂载 + 单独可写挂载：-v ./app:/var/www:ro -v ./runtime:/var/www/runtime
检查 php-fpm.conf 里的 user 和 group 是否与容器内实际用户一致（常见坑：镜像用 www-data，但你自定义了用户却没同步改 fpm 配置）

应该，而且必须在 COPY . /var/www 之前做。否则每次代码变更都会重装全部依赖，镜像层失效，构建变慢，还容易因 Composer 缓存不一致导致线上行为和本地不一致。

实操建议：

分层 COPY：COPY composer.json composer.lock ./ → RUN composer install --no-dev --optimize-autoloader → COPY . .
务必加 --no-dev，生产镜像不需要 phpunit 或 faker 这类开发依赖
如果项目用了 ThinkPHP 的 vendor/bin/think 命令，确认 composer install 后的 bin 目录权限可执行（某些基础镜像默认 umask 会屏蔽 x 权限）
不推荐在容器启动时用 entrypoint 跑 composer install —— 构建阶段就该确定依赖状态

ThinkPHP 的 URL 路由依赖正确的 PATH_INFO 传递，而默认 nginx 配置常把 $fastcgi_script_name 当作脚本路径，导致 $_SERVER['PATH_INFO'] 为空，Route::rule() 全部 fallback 到首页或 404。

docker-container-rerun-all

顺序检查并可选更新所有已在长期记忆中记录了固定重建命令的 docker run 容器。使用场景：用户...

下载

实操建议：

在 location ~ \.php$ 块中显式设置：fastcgi_split_path_info ^(.+\.php)(/.+)$; 和 fastcgi_param PATH_INFO $fastcgi_path_info;
确认 fastcgi_param SCRIPT_FILENAME 指向的是绝对路径，比如 /var/www/public/index.php，而不是相对路径或变量拼接错误
ThinkPHP 6+ 默认开启 app_host 和 url_domain_deploy，若容器外有反代（如 Traefik/Nginx），需在 .env 中设 APP_URL=http://your-domain.com，否则生成的 URL 会漏协议或域名

很多团队在 Docker 里发现 pdo_mysql、redis、opcache 缺失，不是没装，是装错位置或没启用。PHP CLI 和 FPM 加载的 php.ini 文件可能不同，扩展配置文件（docker-php-ext-* 生成的 .ini）也可能被覆盖。

实操建议：

用 docker exec -it your-app php -m 查 CLI 模块，用 curl http://localhost/phpinfo.php | grep -A5 "Loaded Configuration File" 看 FPM 实际加载的 ini 路径
安装扩展后，确认对应 .ini 文件存在于 /usr/local/etc/php/conf.d/ 下（官方 PHP 镜像约定路径），且内容形如 extension=redis.so
禁用 opcache 的开发模式？别删扩展，改 opcache.enable=0 就行；但上线前务必开，否则 ThinkPHP 的模板编译和路由缓存性能损失明显
如果用了 Swoole，注意它和 FPM 互斥 —— 容器里只能选一种运行模式，Swoole 需单独启 php think swoole，不能走 nginx + php-fpm 流程