部署时应通过服务器环境变量设置app_env=production和app_debug=false，禁用.env文件；必须执行php artisan config:clear && config:cache，并确保app_key跨实例一致且为32位。
APP_ENV 和 APP_DEBUG 怎么在部署时安全设置
环境切换本质就是控制 APP_ENV 和 APP_DEBUG 这两个核心配置，但直接改 .env 文件在部署中极易出错——比如 Git 误提交、多环境覆盖、权限问题导致读取失败。
正确做法是绕过 .env，用服务器环境变量接管：
-
APP_ENV=production必须设为production，否则 Laravel 不会启用缓存配置、路由、视图，性能直接受损 -
APP_DEBUG=true在生产环境绝对禁止，不仅暴露敏感路径和 DB 信息，还可能触发异常堆栈写入日志引发磁盘爆满 - Nginx/Apache 中通过
fastcgi_param或SetEnv注入，比依赖.env更可靠；Docker 则用environment:块声明 - 验证是否生效：执行
php artisan tinker后输入app()->environment()和config('app.debug')，结果必须分别是"production"和false
为什么 php artisan config:cache 在部署后必须运行
开发时 Laravel 每次请求都重新加载 config/*.php，但生产环境不 cache 就等于裸奔：配置解析开销大、无法利用 OPCache 预编译优势、甚至某些扩展（如 Horizon）启动直接报错。
常见错误现象：php artisan config:cache 执行失败，提示 “Class not found” 或 “Cannot redeclare function”，根本原因是缓存前没清掉旧的 bootstrap/cache/config.php，或代码里有动态 require 配置文件。
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
- 部署脚本中务必按顺序执行：
php artisan config:clear→php artisan config:cache - 确保所有配置值都是“可序列化”的：不能含闭包、
resource、stdClass实例；env()调用必须只出现在config/*.php中，且不能嵌套在条件语句外层 - 如果用了自定义配置文件（如
config/services.php），检查它是否被config:cache自动包含——默认只扫描config/下 PHP 文件，不含子目录
不同部署方式下 .env 的处理差异
.env 文件不是“部署产物”，而是环境描述符。它的存在位置、读取时机、是否提交到仓库，取决于部署链路设计。
- 传统 FTP/SFTP 部署：把
.env放在/var/www/html/根目录，但必须确保 Web 服务器禁止访问（Nginx 加location ~ /\.env { deny all; }） - Git-based 部署（如 Envoyer）：
.env存在共享目录（如/var/www/myapp/shared/.env），每次发布软链接过去，避免每次覆盖 - Docker 部署：绝不在镜像里 COPY
.env，改用docker run --env-file或docker-compose.yml的environment:字段注入；镜像内只保留.env.example - CI/CD 流水线（如 GitHub Actions）：用 secrets 注入环境变量，再生成临时
.env写入构建上下文，构建完立即删掉，不落盘
APP_KEY 不同步会导致什么问题
APP_KEY 是 Laravel 加密、Session、Cookie、Signed URL 的根基。部署时若新实例用默认 key 或空 key，用户登录态全丢、密码重置链接失效、队列任务解密失败——而且这些错误往往不报异常，只静默失败。
- 错误现象包括：
InvalidSignatureException、Session 无法持久化、Redis 中的laravel_database_session:xxx值为空或乱码 - 必须在首次部署前就生成唯一
APP_KEY（用php artisan key:generate --show），并统一注入所有节点；不能每个实例自己生成 - Key 一旦上线就不能再改，除非你愿意让用户全部重新登录、废弃所有已签名 URL、清空全部 Session 存储
- 检查方式：对比不同服务器上
php artisan tinker中的config('app.key')输出是否完全一致（注意长度：Laravel 9+ 要求 32 字符 AES-256）
环境变量看似简单，但 Laravel 的缓存机制、加密依赖、配置加载顺序会让小疏忽变成线上事故。最常被忽略的是：APP_KEY 必须跨实例一致，而 config:cache 必须在所有环境变量就位后再执行——这两点卡住的人最多。
