codeigniter 中需手动构建符合规范的 xml sitemap:设正确响应头、避免空白/bom、用 base_url() 拼接真实可访问 url、单文件≤50,000 条且≤50mb、分片后配 sitemap_index.xml、流式读取防内存溢出、主动 ping 搜索引擎、lastmod 用 w3c 格式并转义特殊字符。

sitemap 生成在 CodeIgniter 中不是开箱即用的功能,必须手动构造 XML 响应、控制 URL 来源、处理分页与大小限制,否则会触发搜索引擎拒收或抓取失败。
控制器必须设置 Content-type: text/xml 头
浏览器和爬虫依赖 HTTP 响应头识别内容类型。不设头会导致 XML 被当作 HTML 渲染,出现解析错误或乱码。
- 在控制器
index()方法开头加:header('Content-Type: text/xml; charset=utf-8'); - 不能用
$this->output->set_content_type('text/xml')替代——它在某些 CI 版本(如 3.1.11)中会插入额外空白,破坏 XML 格式 - 确保模板文件(如
sitemap.php)顶部无空行、无 BOM 字节,否则XML parsing error: syntax error会直接报错
base_url() 和路由结构必须严格匹配实际可访问路径
生成的每个 <loc></loc> 必须是真实能返回 200 状态码的 URL,否则 Google Search Console 会标记为“无效链接”。
- 若使用自定义路由(如
$route['article-(:num)-(:any)'] = 'content/view/$1/$2';),<loc></loc>必须拼出base_url() . 'article-' . $id . '-' . url_title($title),而不是base_url() . 'content/view/' . $id . '/' . $title - 避免硬编码域名,始终用
base_url()或site_url();但注意site_url()会带index.php,若已移除需配合$config['index_page'] = ''并确认 Apache/Nginx 重写生效 - 检查生成后的 XML 中是否有双斜杠(
//)——常见于base_url() . '/item/' . $slug中base_url()末尾已有/
单个 sitemap.xml 不得超过 50,000 条 URL 且文件体积 ≤ 50MB
超限会导致部分 URL 被忽略,Google 只读取前 50,000 条,Bing 同样有硬性上限。
- 用
$this->db->limit(50000)控制查询结果,再分批生成多个文件(如sitemap1.xml,sitemap2.xml) - 必须配套生成
sitemap_index.xml,格式为:<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><sitemap><loc>https://yoursite.com/sitemap1.xml</loc><lastmod>2026-04-18</lastmod></sitemap>...</sitemapindex> - CI 模型中不要一次性
get()->result_array()全量加载——内存溢出风险高;改用query()->unbuffered_row()流式读取
生成后必须主动通知搜索引擎,不能只靠爬虫发现
静态文件更新后,Google/Bing 不会自动重新抓取 sitemap.xml,尤其对低频更新站点。
- 用
file_get_contents()或cURL手动 ping:https://www.google.com/ping?sitemap=https%3A%2F%2Fyoursite.com%2Fsitemap.xml - CI 中可在控制器末尾加:
file_get_contents('https://www.google.com/ping?sitemap=' . urlencode(site_url('sitemap')));(生产环境建议加ignore_user_abort(true)防止响应中断) - 避免高频 ping:每天最多 1 次,否则可能被限流;更稳妥的做法是写入定时任务(如 Linux cron 调用
wget -q -O /dev/null "https://yoursite.com/sitemap/ping")
实际部署时最容易被忽略的是:XML 中时间字段(<lastmod></lastmod>)必须是 W3C 格式(Y-m-d\TH:i:sP),且所有 URL 必须经过 htmlspecialchars() 转义,否则特殊字符(如 &、)会导致整个文件失效。











