如何在Ubuntu上配置Apache多语言支持

Ubuntu 上配置 Apache 多语言支持

一 准备系统与 Apache 环境

• 更新索引并安装 Apache：sudo apt update & & sudo apt install apache2
• 启用常用模块：sudo a2enmod alias negotiation autoindex dir
• 检查运行状态：sudo systemctl status apache2（如未运行：sudo systemctl start apache2）
• 说明：Ubuntu 的模块与站点配置分别位于 /etc/apache2/mods-available、/etc/apache2/mods-enabled 与 /etc/apache2/sites-available、/etc/apache2/sites-enabled。以上步骤完成后即可进行多语言相关配置。

二 基于内容协商的多语言站点

• 启用内容协商与目录索引：sudo a2enmod negotiation autoindex
• 创建测试目录与多语言文件：
  • mkdir -p /var/www/i18n/{ en,zh}
  • echo ‘< !doctype html> EnglishHello’ > /var/www/i18n/en/index.html
  • echo ‘< !doctype html> 中文你好’ > /var/www/i18n/zh/index.html
• 配置虚拟主机（/etc/apache2/sites-available/i18n.conf）：
  • 建议先复制默认站点：sudo cp /etc/apache2/sites-available/000-default.conf /etc/apache2/sites-available/i18n.conf
  • 在 < VirtualHost *> 内调整：
    • DocumentRoot /var/www/i18n
    • < Directory /var/www/i18n>
      • Options Indexes FollowSymLinks
      • AllowOverride None
      • Require all granted
  • 启用站点：sudo a2ensite i18n.conf & & sudo systemctl reload apache2
• 验证与语言选择：
  • 访问：http://服务器IP/i18n/
  • 通过请求头选择语言（示例）：
    • curl -H “Accept-Language: zh-CN,zh; q=0.9,en; q=0.8” http://服务器IP/i18n/
    • curl -H “Accept-Language: en-US,en; q=0.9” http://服务器IP/i18n/
  • 目录中可放置语言专属后缀文件（如 index.html.en、index.html.zh），Apache 将按协商结果返回；也可用子目录方式组织内容。上述做法依赖 Apache 的 AddLanguage / LanguagePriority / ForceLanguagePriority 等机制完成内容协商。

三 字符集与语言环境建议

• 在 Ubuntu 系统层面启用多语言环境（示例启用简体中文）：
  • 安装语言包：sudo apt install language-pack-zh-hans
  • 生成 locale：sudo vi /etc/locale.gen（取消注释 zh_CN.UTF-8 UTF-8），然后 sudo locale-gen
  • 设置默认语言：echo ‘LANG=zh_CN.UTF-8’ | sudo tee /etc/default/locale
• Apache 侧字符集：
  • 若需统一默认字符集，可在站点或全局配置中使用：AddDefaultCharset UTF-8（注意：现代浏览器通常依据页面内容自动检测字符集，过度强制可能适得其反）。
• 说明：系统 locale 决定了服务器端文本与日志等显示语言；Apache 负责按客户端请求与资源标记进行内容协商与返回。

四 PHP 应用的多语言方案

• 安装与启用 PHP（以 PHP 8.1 为例）：sudo apt install php8.1 libapache2-mod-php8.1
• 安装 GNU gettext：sudo apt install gettext
• 项目结构示例：/var/www/app/index.php 与 /var/www/app/locale/{ en,zh_CN} /LC_MESSAGES/messages.{ po,mo}
• 代码示例（index.php）：
• 生成与编译翻译：
  • xgettext --language=PHP --keyword=_ --output=locale/zh_CN/LC_MESSAGES/messages.po index.php
  • 编辑 .po 添加中文翻译后：msgfmt -o locale/zh_CN/LC_MESSAGES/messages.mo locale/zh_CN/LC_MESSAGES/messages.po
  • 切换语言时修改 putenv/setlocale（如 en_US.UTF-8），并重启 PHP 或 Apache 生效
• 说明：PHP 多语言通常通过 gettext 实现，Apache 负责将请求送达 PHP，语言选择与切换由应用逻辑完成。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！