CodeIgniterMac安装教程详解

Mac 上安装 CodeIgniter 的核心难点并非框架本身，而在于环境配置的“隐形断点”：Apache 或 Nginx 必须显式启用 PHP 模块并正确路由所有请求至 index.php，base_url 绝不能硬编码而需动态生成以适配本地多变路径（如虚拟主机、~username 目录或非标准端口），同时务必警惕 macOS 文件系统对大小写和权限的“虚假宽容”——控制器命名、类名、文件名的大小写不一致或 writable 目录权限不足，虽在本地看似运行无误，却会在部署到真实 Linux 服务器时瞬间引发 404、类加载失败等致命问题，真正绊倒开发者的，永远是这些藏在环境链路最前端的细节。

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 上“恰好能过”的大小写和权限问题——它们安静地躺在本地，等你第一次部署到服务器时集体发难。

本篇关于《CodeIgniterMac安装教程详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！