ThinkPHP如何使用Docker部署-ThinkPHP-PHP中文网

thinkphp容器启动失败主因是runtime目录权限、composer依赖未预装或nginx未正确传递path_info；需分层构建镜像、分离挂载runtime、显式配置fastcgi_split_path_info及script_filename绝对路径。

thinkphp如何使用docker部署

ThinkPHP 容器启动失败，90% 是 runtime 目录权限、composer install 没跑完、或 Nginx 未正确传递 PATH_INFO 导致的——不是代码写错了，是容器环境没对齐。

现象：访问页面空白，php-error.log 里反复出现 failed to open stream: Permission denied，日志、缓存、模板编译全卡在 /runtime/。

别在 Dockerfile 里用 chown -R www-data:www-data /var/www/runtime 硬设权限——不同基础镜像的 www-data UID 可能不一致，重启后挂载目录权限又失效
构建时就创建并设宽松权限：RUN mkdir -p /var/www/runtime/{log,cache,route,view} && chmod -R 777 /var/www/runtime
宿主机挂载时，**禁止** -v ./app:/var/www 这种整项目挂载；改用只读 + 分离挂载：-v ./app:/var/www:ro -v ./runtime:/var/www/runtime:rw
如果用 docker run 启动，加 -u www-data 参数，确保 PHP 进程以容器内有权限的用户运行
检查 php-fpm.conf 中的 user 和 group 是否与实际运行用户一致（比如镜像用 www-data，但你自定义了用户却忘了同步改 fpm 配置）

现象：直接报类找不到，连入口都进不去，不是路由或配置问题，是自动加载链断了。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

Dockerfile 中必须在 COPY 代码前完成依赖安装：COPY composer.json composer.lock ./ → RUN composer install --no-dev --optimize-autoloader → COPY . .
确认 public/index.php 包含 require __DIR__.'/../vendor/autoload.php';（ThinkPHP 6+ 默认有，但手动删过就得补）
别在 ENTRYPOINT 或 CMD 里动态执行 composer install——构建阶段就该确定依赖状态，否则每次启动都慢且不可控
运行容器后执行 docker exec -it your-app php -m | grep opcache，确保 opcache 已启用，否则自动加载性能会明显下降

现象：访问 /index.php/user/login 正常，但去掉 index.php 就 404；或者所有请求都 fallback 到首页。

root 必须指向 public/ 目录，不能是项目根目录；例如 root /var/www/html/public;
location / 块必须用：try_files $uri $uri/ /index.php?$query_string; —— 缺少 $query_string 会导致 GET 参数丢失
location ~ \.php$ 中必须显式设置：fastcgi_split_path_info ^(.+\.php)(/.+)$; 和 fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param SCRIPT_FILENAME 必须为绝对路径：$document_root$fastcgi_script_name，不能拼错成 $fastcgi_script_name 或相对路径
伪静态规则由 Nginx 容器负责，PHP-FPM 容器本身不处理 URL 重写；改 .htaccess 或 ThinkPHP 的 url_rewrite 配置在纯 FPM 容器里完全无效

现象：队列任务起不来、日志混写、缓存键错乱、甚至 flock() 失败；不是并发高，是目录被多个容器同时写。

.env 绝对不能 COPY 进镜像；用 docker-compose.yml 的 env_file: 或 environment: 注入，并确保它落在容器内项目根目录（如 /var/www/.env）
Web 容器和 queue:work 容器**不能共享同一份 runtime 挂载**；应分离：web 挂载 runtime/log 和 runtime/cache，queue 容器挂载 runtime/queue 和 runtime/log（若需隔离可再分卷）
SELinux 主机（如 CentOS）挂载后可能静默拒绝写入，报错仍是 Permission denied，但需额外加 :z 或 :Z 标签：-v ./runtime:/var/www/runtime:z
容器重启前，建议清空 runtime/cache/ 和 runtime/route/，避免旧 opcode 或路由缓存干扰新版本逻辑