macos和linux部署thinkphp时环境变量失效、数据库连接失败等问题，主因是shell初始化文件差异（zsh用~/.zshrc、bash用~/.bashrc）、php cli与web php.ini路径不一致、.env格式错误或加载顺序被系统变量覆盖，需分层验证并统一配置。
在 macOS 和 Linux 系统上部署 ThinkPHP 项目时，若遇到数据库连接失败、扩展未加载、runtime 目录权限拒绝或环境变量始终读不到 .env 中的值，大概率是 PHP 环境变量配置路径混乱、作用域错位或加载时机被覆盖导致的——这两个系统虽同属 Unix-like，但 shell 初始化机制、默认配置文件位置、PHP 运行用户权限模型完全不同，不能套用同一套操作。
确认当前 Shell 类型并定位环境变量生效文件
执行 echo $SHELL 查看当前 shell；macOS 默认使用 zsh（≥Catalina），Linux 多为 bash，二者初始化文件不同。
zsh 用户编辑 ~/.zshrc，bash 用户编辑 ~/.bashrc；若项目由 systemd 或 php-fpm 启动，则需额外配置服务级环境变量，而非仅改用户级文件。
这一步漏掉会导致后续所有 export 都只在当前终端生效，Web 请求完全读不到——【PHP-FPM 或 Apache 子进程不继承交互式 shell 的环境变量】。
为 CLI 和 Web 一致设置 PHP 可执行路径与扩展目录
方法一：统一使用 Homebrew 安装的 PHP（推荐 macOS）
运行 brew install php 后，Homebrew 会输出类似 /opt/homebrew/bin/php 的路径；将该路径加入 ~/.zshrc：export PATH="/opt/homebrew/bin:$PATH"，再执行 source ~/.zshrc。
验证 CLI 是否生效：which php 应返回 Homebrew 路径，php -m | grep pdo_mysql 必须有输出；否则需手动启用扩展——Homebrew 安装的 php.ini 通常位于 /opt/homebrew/etc/php/8.3/php.ini（版本号随安装变动），打开后取消注释 extension=pdo_mysql 行。
方法二：Linux 下用 apt/dnf 安装后强制对齐 CLI 与 Web 使用的 php.ini
Ubuntu 执行 sudo apt install php-cli php-mbstring php-xml php-zip php-curl php-pdo php-mysql；CentOS 执行 sudo dnf install php-cli php-mbstring php-xml php-zip php-curl php-pdo php-mysqlnd。
关键点：Apache 模块和 CLI 默认可能指向不同 php.ini。执行 php --ini 查 CLI 加载路径，执行 phpinfo() 页面查 Web 加载路径；若不一致，必须统一软链或修改 Apache/PHP-FPM 配置指向同一份 ini 文件，否则 opcache.enable=1 在 CLI 开了，Web 里仍是关闭状态。
ThinkPHP 环境变量加载顺序与覆盖陷阱
第一步：确保 .env 文件位于项目根目录且格式严格合规
等号两侧绝对不能有空格，含空格的值必须用单引号包裹，例如 REDIS_PASSWORD='my pass!'；注释行必须以 # 开头且前面无空格；【一旦格式错误，vlucas/phpdotenv 会静默跳过整行，不报错也不提示】。
第二步：验证框架是否真从 .env 加载，而非 fallback 到 config/*.php 默认值
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...
在控制器中写 dump(env('APP_DEBUG', 'not_set'));，访问页面；若返回 not_set，说明 .env 未加载成功——常见原因是 runtime/cache/ 缓存未清，或 think\initializer\Env 初始化器被手动注销。
第三步：绕过 .env 文件，直接向 Web 服务器注入环境变量（生产环境强推）
Apache 下，在虚拟主机配置中添加：SetEnv APP_ENV production 和 SetEnv DB_HOST 10.0.2.100；Nginx 下，在 server 块内加：fastcgi_param APP_ENV "production"; 与 fastcgi_param DB_HOST "10.0.2.100";。
注意：PHP 的 variables_order 必须包含 E（即 php.ini 中 variables_order = "EGPCS"），否则 fastcgi_param 不会被 PHP 接收。
修复 MySQL 连接失败：localhost ≠ 127.0.0.1
macOS 上 Homebrew 安装的 MySQL 默认监听 Unix socket，路径为 /opt/homebrew/var/mysql/mysql.sock（Apple Silicon）或 /usr/local/var/mysql/mysql.sock（Intel）；Linux 上多为 /var/run/mysqld/mysqld.sock。
ThinkPHP 配置中若写 'hostname' => 'localhost'，PHP 会尝试走 socket 连接；但若 socket 路径不对，就会报 SQLSTATE[HY000] [2002] No such file or directory。
解决方案：统一强制走 TCP 连接，把 hostname 改为 127.0.0.1；同时在 .env 中明确指定端口：DB_PORT=3306。
这比修改 mysql.default_socket 更可靠，因为不同部署方式下 socket 路径不可预测，而 TCP 端口稳定可控。
设置 runtime 目录权限并禁用 opcache 预编译干扰
执行 chmod -R 755 runtime/（非 777！）；若用 php-fpm，还需确认运行用户（如 www-data 或 _www）对 runtime/ 有写权限。
ThinkPHP 6+ 默认启用路由缓存，依赖 opcache；但 macOS Monterey 及更新系统默认禁用 opcache，Linux 发行版也常默认关闭。
检查 php.ini 中是否启用：zend_extension=opcache（非 extension=opcache）；并确认 opcache.enable=1 与 opcache.enable_cli=1 均为 on——后者决定 CLI 命令（如 php think）能否利用缓存。
修改 php.ini 后必须重启 php-fpm 或 Apache，service php8.3-fpm restart 或 sudo apachectl restart；仅 reload 不生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
