CodeIgniter Mac安装要点及注意事项

在Mac上安装CodeIgniter看似简单，实则暗藏三大关键陷阱：Web服务器（Apache/Nginx）必须显式配置以正确识别并路由至index.php，否则连欢迎页都无法加载；base_url绝不能硬编码为localhost，而需动态生成以适配本地多端口、虚拟主机或~username路径等真实开发场景；更易被忽视的是Mac文件系统对大小写“假装宽容”的假象——控制器类名、文件名、模型加载名若不严格遵循首字母大写等CI规范，将在部署到Linux生产环境时瞬间引发404或Class not found错误，配合writable目录权限配置不当，共同构成本地能跑、上线即崩的经典困局。

Mac 上装 CodeIgniter，核心就一条：别让 index.php 被系统或 Web 服务“看不见”。 macOS 自带 Apache（或你用 XAMPP/MAMP）默认不启用 PHP 模块、不处理重写规则、不自动识别 CI 的入口文件路径——这不是 CI 本身的问题，是环境链路断在了最前面。

Apache 或 Nginx 配置必须显式支持 index.php 入口

Mac 自带 Apache（/etc/apache2/）默认只把 index.html 当首页，index.php 会被忽略；Nginx 更严格，默认不执行 PHP 文件。不配好这一层，连欢迎页都出不来。

• Apache：确认 LoadModule php_module libexec/apache2/libphp.so 已取消注释，且 DirectoryIndex 包含 index.php
• Nginx：必须在 location / 块里加 try_files $uri $uri/ /index.php?$query_string;，否则所有路由 404
• XAMPP 用户：直接把整个 CI 文件夹丢进 /Applications/XAMPP/xamppfiles/htdocs/ 即可，但要访问 http://localhost/your-ci-folder/，不是 http://localhost/ —— 否则会撞上 XAMPP 自带首页

application/config/config.php 的 base_url 别硬写 localhost

CI 不靠域名推断路径，全靠这个配置生成资源链接（CSS/JS/图片）。写死 http://localhost 在 Mac 本地开发时看似能用，但一旦换端口、换虚拟主机、或用 ~username 路径（如 http://localhost/~yanzi/myapp），所有静态资源立刻 404。

• 推荐写法：$config['base_url'] = 'http://'.$_SERVER['HTTP_HOST'].dirname($_SERVER['SCRIPT_NAME']).'/';
• 或者更稳：用 $_SERVER['DOCUMENT_ROOT'] 和当前脚本位置算出相对路径，再拼成 URL
• 验证方法：在视图里输出 ，看浏览器 Network 标签里请求地址是否正确

文件权限和大小写敏感性在 Mac 上“假装宽容”，上线就炸

macOS 默认文件系统（APFS）对大小写不敏感，但绝大多数 Linux 服务器（包括阿里云、AWS）是严格区分大小写的。CI 的控制器类名、文件名、类内方法名，差一个大写就报 404 Not Found 或 Class not found。

• 控制器文件必须首字母大写：比如 Users.php，不是 users.php；类名也必须是 class Users extends CI_Controller
• Mac 下用小写命名可能“跑得通”，但一上传到生产环境，$this->load->model('user_model'); 就失败——因为实际文件是 User_model.php
• PHP 扩展权限也要检查：application/ 和 writable/（CI4）或 application/logs/（CI3）目录需对 Web 进程可写，Mac 上常被误设为仅用户可写

真正卡住人的从来不是下载解压那一步，而是 Apache/Nginx 怎么把请求准确扔给 index.php、base_url 怎么不随环境失效、以及那些在 Mac 上“恰好能过”的大小写和权限问题——它们安静地躺在本地，等你第一次部署到服务器时集体发难。

今天关于《CodeIgniter Mac安装要点及注意事项》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！