如何将服务器端Laravel项目导入Laravel Sail Docker镜像

你拿到完整项目文件的前提下，完全可以构建出正常运行的Docker容器，不需要基于你新建的示例Laravel项目改。

先确认你复制的https目录为项目根目录，避免后续做无用功：

• 检查目录下是否存在artisan、.env、composer.json、composer.lock四个核心文件，存在即说明目录层级正确，不是只复制了公开资源目录。
• 全程严格使用PHP 7.1.3版本环境，不要用PHP7.2+甚至8.x版本，适配PHP7.1的Laravel版本存在大量高版本下的语法兼容问题，会直接启动报错。
• 检查目录下是否存在内容完整的vendor文件夹，从运行中的服务器复制的项目一般已经预装了所有依赖，不需要重新执行composer安装，可以省很多适配步骤。

不要直接在本地物理机安装PHP环境调试，PHP7.1版本过旧，和新版Windows/macOS/Linux桌面版都存在兼容问题，直接在Docker环境下调试，和最终打包的运行环境完全一致，不会出现环境差异导致的异常：

• 权限问题是Laravel老版本最高发的启动失败原因：项目下的storage、bootstrap/cache两个目录必须给PHP运行进程的所属用户（一般镜像内默认是www-data）开放读写权限，否则会出现日志写入失败、缓存无法生成的500错误。
• 配置适配：不要直接使用原服务器上的.env配置，将其中的数据库、Redis、缓存、队列服务的连接地址、账号密码替换为你本地测试环境的对应参数。如果.env文件内没有填写APP_KEY参数，执行php artisan key:generate生成应用密钥，否则会出现加密解密异常。
• 依赖安装：如果目录下没有完整的vendor文件夹，不要在本地物理机执行composer安装命令，直接在PHP7.1.3的容器内执行composer install --no-dev --optimize-autoloader，避免本地高版本composer生成的依赖和PHP7.1不兼容。依赖安装完成后依次执行php artisan config:clear、php artisan route:clear、php artisan cache:clear清除旧的服务器缓存即可。
• 排查问题时直接看storage/logs下的日志文件，所有Laravel运行报错都会存在这里，不用瞎猜问题。

• 基础镜像直接选官方php:7.1.3-fpm即可，别花里胡哨选第三方封装的镜像，减少未知问题。构建镜像时只需要安装几个必备扩展：pdo_mysql、mbstring、xml、zip、bcmath，足够支撑对应版本Laravel运行，多余扩展不用装，避免增大镜像体积。
• 权限修正命令要写在容器启动入口脚本里，不要写在镜像构建层，否则后续目录挂载时会覆盖构建层设置的权限。
• 搭配Nginx容器做Web转发时，Nginx的站点根目录必须指向项目内的public文件夹，不能指向项目根目录，否则会暴露.env等敏感文件，同时会出现入口文件找不到的404错误。
• 打包完成后先本地启动容器组（PHP容器、Nginx容器、项目依赖的数据库/Redis容器）做验证，能正常访问首页、业务接口无报错再推送到镜像仓库。

内容的提问来源于stack exchange，提问作者waitwhat