site_url() 生成带 index.php(或配置的 index_page)的控制器方法跳转或表单提交用的完整 URL,不适用于静态资源;需加载 url_helper 才能使用,传参推荐数组形式以避免编码和拼接错误。

site_url() 是什么,它到底生成哪种 URL
site_url() 的作用是拼出带 index.php(或你配置的 index_page)的、可用于控制器方法跳转或表单提交的完整路径。它不返回网站根地址,也不适合引用 CSS/JS/图片——那是 base_url() 的事。
比如你访问 http://localhost/myapp/index.php/welcome/hello,site_url('welcome/hello') 就会原样输出这个地址;而 base_url('css/app.css') 输出的是 http://localhost/myapp/css/app.css(没 index.php)。
- 它读取
app/Config/App.php(CI4)或application/config/config.php(CI3)里的baseURL和indexPage配置 - 自动追加你在
url_suffix里设的后缀(如.html) - 传入的 URI 段支持字符串(
'user/login')或数组(['user', 'profile', '123']),后者更安全,避免手动拼接斜杠错误
不加载 helper 就调用 site_url() 会怎样
直接报错:Call to undefined function site_url()。这不是“找不到类”,而是函数根本不存在——site_url() 不是 PHP 内置函数,也不是 CI 自动加载的,它来自 url_helper.php。
- CI3:必须在控制器或视图里先执行
$this->load->helper('url');或者在application/config/autoload.php中把'url'加进$autoload['helper'] - CI4:默认已自动加载,但如果你在自定义命令、中间件或非标准上下文里用,仍可能失效,此时需手动
helper('url') - 常见坑:在模型(Model)里直接调用
site_url()—— CI3 的 Model 默认不继承 CI_Controller,没有$this->load,也没自动加载 helper;CI4 的 Model 更干净,连 helper 都不推荐在里面用
为什么不能用 site_url() 加载静态资源
因为 site_url() 强制塞入 index.php,导致浏览器请求 http://example.com/index.php/css/style.css,服务器当然 404——静态文件不该走路由入口。
- 正确做法:用
base_url('css/style.css'),它只拼基础路径,不碰index.php - 混淆点:有些老项目把 CSS 放在
application/views/css/下,试图用site_url('css/style.css')访问——这不仅路径错,还暴露了应用结构,有安全隐患 - 额外提醒:如果开了伪静态(隐藏
index.php),site_url()仍会输出带index.php的链接,除非你同时改了indexPage = ''并配好重写规则,否则前端行为和后端生成不一致
传参时用字符串还是数组,差别在哪
本质一样,但数组方式更健壮,尤其涉及动态 ID 或含斜杠、问号的参数时。
- 字符串:
site_url('article/view/123?ref=home')—— 看似简单,但?会被当字面量,实际生成.../view/123%3Fref=home,路由收不到ref - 数组:
site_url(['article', 'view', '123']) . '?ref=home'或配合http_build_query()手动拼查询参数,更可控 - CI4 支持更灵活的数组嵌套:
site_url(['admin', 'users', 'edit', $id]),自动处理 URL 编码,比手拼"admin/users/edit/{$id}"安全得多
真正容易被忽略的是:site_url() 从不解析查询参数,它只负责路径段。所有 ? 后面的东西,得你自己拼、自己编码,别指望它帮你做。










