M1/M2 Mac搭ThinkPHP需绕开ARM架构、PHP扩展、Web服务器转发和MySQL连接四类陷阱：确认Homebrew PHP版本≥7.2且pdo_mysql/mbstring/opcache等扩展已启用；Apache/Nginx必须精准配置PATH_INFO伪静态规则；MySQL连接强制用127.0.0.1避免socket路径错误；runtime目录赋权、.env编码为UTF-8无BOM，并确保CLI与Web加载同一php.ini。
在M1/M2 Mac上搭ThinkPHP，不是“装完就能跑”，而是要绕开ARM架构、PHP扩展、Web服务器转发和MySQL连接四类典型陷阱。关键不在步骤多，而在每一步都得匹配arm64原生逻辑。
确认PHP版本与核心扩展是否真正就位
macOS自带PHP已弃用，Homebrew安装的php@8.2或php@8.3才是正解。但装完不等于可用——很多报错如Class 'PDO' not found或mb_strlen(): Argument #1 ($string) must be of type string，根源是扩展没加载，而非没安装。
- 运行
php -v确认CLI用的是/opt/homebrew/bin/php（非/usr/bin/php），且版本≥7.2 - 执行
php -m | grep -E "pdo|mbstring|curl|opcache"，缺哪个就补哪个：比如brew install php@8.3-mysql，再检查php.ini里是否启用了extension=pdo_mysql.so和zend_extension=opcache - ThinkPHP 6路由缓存强依赖opcache，Monterey及更新系统默认禁用，必须手动取消
php.ini中zend_extension=opcache的注释
Apache/Nginx伪静态必须精准适配PATH_INFO
访问http://localhost/index/index直接404？不是ThinkPHP写错了，是Web服务器根本没把请求交给index.php处理，$_SERVER['PATH_INFO']为空导致路由失效。
- Apache下：确保
/opt/homebrew/etc/httpd/httpd.conf中LoadModule rewrite_module libexec/mod_rewrite.so已启用，且项目目录配置含AllowOverride All；根目录.htaccess内容必须为：
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php [L] - Nginx下：server块内不能只写
try_files $uri $uri/ =404，必须加try_files $uri $uri/ /index.php?$query_string;，并确保fastcgi_param SCRIPT_NAME /index.php;未被覆盖 - 别用
php -S内置服务器——它压根不支持PATH_INFO，ThinkPHP 6默认模式必然挂掉；改用php think run（需chmod +x think）
MySQL连接务必用127.0.0.1，避开Unix socket路径坑
配置写'hostname' => 'localhost'，启动就报SQLSTATE[HY000] [2002] No such file or directory？这是M系列Mac最经典的“本地连接失败”假象——localhost走Unix socket，而Homebrew安装的MySQL socket路径在/opt/homebrew/var/mysql/mysql.sock（ARM芯片），旧教程里的/usr/local/var/mysql/mysql.sock根本不存在。
立即学习“PHP免费学习笔记（深入）”；
- 查真实socket路径：
mysql_config --socket或brew services list | grep mysql - ThinkPHP数据库配置中，强制写
'hostname' => '127.0.0.1'，彻底绕过socket查找 - 若必须用
localhost，则在php.ini中显式指定mysql.default_socket = /opt/homebrew/var/mysql/mysql.sock（Apple Silicon路径）
权限、编码与环境一致性细节
有些问题看似随机，实则是runtime目录不可写、.env编码带BOM、或CLI与Web用的不是同一份php.ini。
-
runtime/目录需赋予当前用户读写权限：chmod -R 755 runtime，否则日志、缓存全失败 -
.env必须放在项目根目录（与think文件同级），且编码为UTF-8 without BOM（VS Code或Sublime可设，Windows记事本默认带BOM） - 验证CLI与Web环境是否一致：在浏览器打开
phpinfo()，对比“Loaded Configuration File”路径，再运行php --ini看CLI加载的是哪个php.ini；不一致时，修改对应ini文件，或用php --php-ini /path/to/php.ini -m测试
