PHP 网站

PHP 网站用于运行 PHP 程序，如 WordPress、Laravel、ThinkPHP 等。

前置要求

创建 PHP 网站前，需要先安装：

1. Web 服务器：Nginx、OpenResty、Apache、OpenLiteSpeed 或 Caddy
2. PHP 运行环境：在 应用 > 运行环境中安装所需 PHP 版本

创建 PHP 网站

1. 进入 网站 页面
2. 点击 PHP 选项卡
3. 点击 创建网站

配置项

• 名称：网站标识，例如 wordpress。仅允许使用字母、数字、连字符和下划线
• 域名：绑定的域名，如 blog.example.com
• 端口：监听端口，默认 80
• PHP 版本：选择已安装的 PHP 版本
• 数据库：可选择已安装的数据库类型，在创建网站的同时一并创建数据库、用户和密码
• 目录：网站文件的存放路径。若留空，则默认为网站目录加上 <name>/public
• 备注：可选备注

编辑 PHP 网站

点击网站列表中的 编辑 按钮进入编辑页面。

可以在基本设置中切换为反向代理或纯静态网站。域名、监听、文件等通用内容会保留；PHP 运行环境、Rewrite 等 PHP 专属 Web 配置会删除，并重新生成所选类型的配置。切换前必须备份网站并记录 PHP 设置。

域名和监听

配置网站的域名和监听端口。

基本设置

配置网站目录、PHP 版本等基本信息。

• 网站目录：网站文件存放的绝对路径
• 运行目录：Laravel 等框架需要设置运行目录
• 默认文档：默认首页文件，如 index.php、index.html
• PHP 版本：选择已安装的 PHP 版本
• 防跨站攻击：启用后会设置 open_basedir，使 PHP 只能访问网站目录（以及 /tmp）内的文件

伪静态配置

伪静态用于 URL 重写，支持常见 PHP 程序的预设规则。

点击预设下拉框可以选择常见程序的伪静态规则：

面板内置以下 27 个预设：

crmeb、dabr、dbshop、dedecms、discuz、discuzq、discuzx、drupal、ecshop、edusoho、emlog、empirecms、laravel、maccms、niushop、pbootcms、phpcms、phpwind、sablog、seacms、shopex、shopwind、thinkphp、typecho、wordpress、wordpress-multisite、zblog。

选择预设后，规则会写入下方编辑器，可以继续调整再保存。

注意

只有使用 Nginx 时才显示预设下拉框（预设仅适用于 Nginx/OpenResty）。对于其他 Web 服务器，请使用当前服务器的语法编写规则。 OpenLiteSpeed 通过网站级别的 .htaccess 加载重写规则。

HTTPS

为网站启用并配置 HTTPS。

• 总开关：启用或关闭 HTTPS。启用后，面板会自动增加 443 监听，Nginx 还会增加 quic
• 使用已有证书： 从证书管理中选择证书，自动填充证书和私钥。
• HSTS： 强制浏览器仅使用 HTTPS。
• HTTP 重定向： 自动将 HTTP 请求跳转到 HTTPS。
• OCSP Stapling： 启用 OCSP 装订。
• TLS 版本： 可选 TLS 1.0、1.1、1.2 和 1.3。
• 证书 / 私钥：直接粘贴 PEM 证书和 KEY 私钥内容

网站已绑定域名时，底部 一键签发证书可以通过 ACME 申请免费证书。存在 *.example.com 等通配符域名时，需要选择已经在证书管理中添加的 DNS 提供商进行 DNS 验证。

一键签发证书成功后，AcePanel 会自动为网站开启 HTTPS。请在 HTTPS 标签页中检查生成的证书和监听设置。

重定向

配置重定向规则。每条规则支持：

• 类型： URL 重定向、Host 重定向或 404 重定向。
• 状态码： 301、302、307 或 308。
• 来源 / 目标：要匹配的路径或主机以及目标地址
• 保留 URI： 跳转时保留原请求路径和查询参数。

高级设置

• 访问统计（Nginx、OpenResty 或 Caddy）：开启或关闭此网站的访问统计采集
• 日志设置：设置 访问日志和 错误日志路径，或将其设为 关闭
• 限流：设置 并发限制、单 IP 限制和 速率限制
• 真实 IP： 网站位于 CDN 或 Frp 后方时，配置每行一个的可信代理 IP、真实 IP 请求头和递归查找。
• 基本身份验证：添加适用于整个网站或指定 URL 目录的规则，然后添加用户名和密码。目录规则需填写 /admin/ 这样的路径；更具体的路径优先匹配

自定义配置

可以追加 Web 服务器配置片段。每个片段都有名称、作用域（此网站或全局），以及使用当前 Web 服务器语法编写的内容块。

访问日志和错误日志

启用对应日志路径后，访问日志和 错误日志选项卡会实时显示日志文件。底部 清空日志会截断当前查看的日志文件。

注意

点击编辑对话框底部的 重置配置，会根据面板模板重新生成网站的 Web 服务器配置，并丢弃对生成配置文件所做的手工修改。

网站目录结构

默认目录结构：

/opt/ace/sites/website-name/public
├── index.php          # 入口文件
├── .user.ini          # PHP 配置
└── ...

切换 PHP 版本

可以在网站编辑页的 基本设置 中切换 PHP 版本：

1. 打开网站编辑页。
2. 进入 基本设置。
3. 在 PHP 版本中选择新版本。
4. 点击 保存。

注意

切换 PHP 版本可能导致程序不兼容，应先在测试环境验证。

PHP 管理页面

进入 应用 > 运行环境，点击已安装 PHP 版本的 管理，打开 PHP 管理页。页面包含：

• 运行状态： 查看 php-fpm-<version> 服务状态，提供启动、停止、重启和重载；此处还提供两项操作：
  • 设为 CLI 默认版本：将此 PHP 版本设为系统 CLI 中默认的 php 命令
  • 查看 PHPInfo：打开弹窗查看该版本完整的 phpinfo() 输出
• 模块管理： 安装或卸载 PHP 扩展。
• 参数调优：通过表单调整常用参数（参阅参数调优）
• 主配置： 编辑原始 php.ini。
• FPM 配置： 编辑 PHP-FPM 配置文件。
• 负载状态：使用 FPM 时查看 PHP-FPM 负载和工作进程指标
• OPcache：查看缓存用量及已缓存脚本，或重置缓存
• Composer：安装或更新 Composer，并配置其软件包镜像源
• 运行日志：实时查看 php-fpm-<version> 服务的运行日志
• 错误日志：实时查看 PHP 错误日志；点击 清空日志可截断文件
• 慢日志：实时查看 PHP-FPM 慢日志；点击 清空慢日志可截断文件

OpenLiteSpeed 通过 LSAPI 处理 PHP 时，PHP-FPM 服务停止属于正常情况。 FPM 控件和指标不适用于管理 LSAPI 工作进程。有关运行行为，请参见 OpenLiteSpeed 下的 PHP。

模块管理

模块管理选项卡列出所选版本支持的扩展。安装或删除操作。安装会创建后台任务，安装和卸载都需要确认。

可用扩展包括 fileinfo、OPcache、igbinary、Redis（依赖 igbinary）、Memcached、APCu、ImageMagick、exif、pgsql / pdo_pgsql、sqlsrv / pdo_sqlsrv、imap、zip、bz2、ssh2、event、readline、snmp、ldap、enchant、pspell、calendar、gmp、xlswriter、xsl、intl、gettext、grpc、protobuf、rdkafka、xhprof、Xdebug、yaml、zstd、sysvmsg / sysvsem / sysvshm、ionCube、Swoole 和 Swow。

版本差异

可用扩展会随 PHP 版本变化：Swow 仅支持 PHP 8.0 及以上版本；PHP 8.4 及以上不再提供 pspell 和 imap；PHP 8.5 及以上已内置 OPcache，不再将其作为可安装扩展。

参数调优

参数调优 选项卡将常用设置分组为多个子选项卡，无需手工编辑文件即可调整：

• 常规： short_open_tag、date.timezone、display_errors、error_reporting。
• 禁用函数：编辑 disable_functions 列表（参阅禁用函数）
• 上传限制： upload_max_filesize、post_max_size、max_file_uploads、memory_limit。
• 超时限制： max_execution_time、max_input_time、max_input_vars。
• 性能调优：写入 php-fpm.conf 的 PHP-FPM 进程管理器设置，包括 pm、pm.max_children，以及 dynamic 模式下的 pm.start_servers、pm.min_spare_servers 和 pm.max_spare_servers
• OPcache：字节码缓存和 JIT 设置
• 会话：配置 session.save_handler（files、redis 或 memcached）、保存路径、session.gc_maxlifetime 及 session.cookie_lifetime。清理会话文件会删除该版本全部会话文件。

PHP 配置

php.ini 配置

可以在 PHP 管理页的 主配置中编辑 php.ini。常用项目也可通过参数调优修改：

对于常用项目，参数调优 选项卡提供表单，无需手工编辑文件即可调整：

upload_max_filesize = 50M
post_max_size = 50M
max_execution_time = 300
memory_limit = 256M

禁用函数

PHP 默认禁用 exec、system、passthru 等危险函数。如需启用，请编辑 php.ini 中的 disable_functions 值，或在 PHP 管理页的 参数调优 选项卡中修改 禁用函数 字段。

警告

启用危险函数会增加安全风险，必须确认程序确实需要并采取额外隔离措施。

常见问题

502 Bad Gateway

• 检查 PHP-FPM 是否正常运行。
• 检查网站选择的 PHP 版本是否正确。

文件上传失败

• 检查 upload_max_filesize 和 post_max_size。
• 检查目录权限。

页面空白

• 临时启用 PHP 错误显示。
• 检查 PHP 错误日志。