macOS安装Yii2后通过MAMP环境运行的配置说明【说明】-php教程-PHP中文网

macOS上用MAMP跑Yii2，核心是DocumentRoot必须指向web/子目录、启用mod_rewrite并配置AllowOverride All、数据库连接使用127.0.0.1或指定MAMP MySQL socket路径，三者缺一不可。

macos安装yii2后通过mamp环境运行的配置说明【说明】

macOS上用MAMP跑Yii2，核心不是“能不能启动”，而是Web根目录指向、重写支持、数据库连接路径这三点对不对。错一个，轻则404、白屏，重则敏感目录暴露或数据库连不上。

MAMP默认把项目放/Applications/MAMP/htdocs/，但Yii2的入口不在项目根，而在web/子目录。直接把整个项目拖进htdocs，Apache会把config/、controllers/这些目录暴露在Web下，极不安全。

正确做法：在MAMP GUI里选中站点 → “Host Settings” → “Document Root”，填绝对路径，例如/Users/yourname/myproject/web
若用MAMP Pro，也可在httpd.conf或虚拟主机配置中手动写：DocumentRoot "/Users/yourname/myproject/web"
改完务必重启MAMP（不是刷新页面），否则配置不生效

Yii2的友好URL（如/site/about）依赖Apache通过.htaccess做前端控制器转发。MAMP默认禁用该功能，导致路由根本到不了PHP。

Todo List for MacOS

仅限macOS - 通过AppleScript管理macOS提醒事项应用。支持全功能提醒管理：添加、列出、完成、删除、搜索、创建列表等。

下载

打开/Applications/MAMP/conf/apache/httpd.conf，确认以下两行已取消注释：
LoadModule rewrite_module modules/mod_rewrite.so
Include /Applications/MAMP/conf/apache/extra/httpd-vhosts.conf
在对应虚拟主机的块内添加：AllowOverride All
检查web/.htaccess是否存在且内容为Yii2官方标准版本（含RewriteEngine On和正确的RewriteRule）

MAMP的MySQL不走系统默认socket（/tmp/mysql.sock），直接用localhost可能报错No such file or directory。

推荐方式：用127.0.0.1代替localhost，避免Unix socket查找失败
或显式指定socket路径，在common/config/main-local.php中这样写：
'dsn' => 'mysql:host=127.0.0.1;port=8889;dbname=yii2advanced',
其中8889是MAMP MySQL端口（可在MAMP偏好设置里查）
确保pdo_mysql扩展已在MAMP对应PHP版本的php.ini中启用

如果访问时提示Class 'yii\web\Application' not found，大概率是自动加载路径断了。

确认项目结构为标准格式：
myproject/
├── web/
│ └── index.php
├── vendor/
├── composer.json
└── ...
检查web/index.php第一行：require __DIR__ . '/../vendor/autoload.php'; —— 这个../是相对于web/的，所以vendor/必须与web/同级
不要用localhost:8888/myproject/web/这种子路径访问，会导致相对路径全部错位