Apache 配置 Zend Framework 指南

要配置 Apache 以使用 Zend Framework (现在称为 Laminas)，您需要按照以下步骤操作：

基本配置步骤

1. 确保已安装 Zend Framework

   • 使用 Composer 安装：composer require zendframework/zendframework
   • 或者下载并解压到您的项目目录

2. Apache 虚拟主机配置

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot "/path/to/your/project/public"

    <Directory "/path/to/your/project/public">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted

        # 如果使用 Apache 2.4+
        # Require all granted

        # 重写规则
        RewriteEngine On
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteRule ^.*$ index.php [NC,L]
    </Directory>

    # 可选：设置环境变量
    SetEnv APPLICATION_ENV "development"
</VirtualHost>

3. .htaccess 文件配置 (位于 public 目录)

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^.*$ index.php [NC,L]

高级配置选项

1. 配置不同的环境

SetEnv APPLICATION_ENV "production"
# 或
SetEnv APPLICATION_ENV "development"

2. URL 重写优化

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} -s [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^.*$ - [NC,L]
RewriteRule ^.*$ index.php [NC,L]

3. 性能优化

# 启用压缩
AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript

# 设置过期头
<IfModule mod_expires.c>
    ExpiresActive On
    ExpiresDefault "access plus 1 year"
</IfModule>

常见问题解决

1. 403 Forbidden 错误

   • 确保 Apache 对项目目录有读取权限
   • 检查 AllowOverride All 是否设置

2. 500 Internal Server Error

   • 检查 Apache 错误日志
   • 确保 mod_rewrite 已启用 (a2enmod rewrite)

3. URL 重写不工作

   • 确认 AllowOverride All 已设置
   • 检查 .htaccess 文件是否存在且内容正确

4. 启用必要的 Apache 模块

   sudo a2enmod rewrite
   sudo systemctl restart apache2
   

注意事项

• 确保您的 public 目录是 Web 服务器的文档根目录
• 生产环境中应考虑禁用目录列表 (Options -Indexes)
• 对于 Zend Framework 1 和 Zend Framework 2/3 配置略有不同
• Zend Framework 已迁移到 Laminas 项目，新项目建议使用 Laminas

如需更详细的配置，请参考您使用的 Zend Framework 版本的官方文档。