在 Plesk 上安装 Joomla
在您的 Plesk 托管空间上安装 Joomla:PHP 和数据库要求、上传官方安装包、安装向导、友好 URL 以及常见错误的解决方法。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南介绍如何使用官方安装包在您的 Plesk 托管空间上安装 Joomla,然后确认网站及其管理后台运行正常。
前提条件
- 能够访问您的 Plesk 面板(参见连接到 Plesk 界面)。
- 一个已绑定到您的托管空间并指向该空间的域名。
- 一个空的
httpdocs目录;如果其中已有网站,请先备份。
本指南使用 httpdocs,这是主域名通常使用的目录。附加域名的目录可能不同:请在 主机与 DNS > 主机 中查看 文档根目录。
以下是 Joomla 6 的官方要求,这是撰写本指南时的当前版本分支。如果您要安装更高版本,请在 Joomla 手册中进行核实。
| 项目 | 支持的最低版本 | 推荐版本 |
|---|---|---|
| PHP | 8.3.0 | 8.4 |
| MySQL | 8.0.13 | 8.4 |
| MariaDB | 10.6(绝对最低为 10.4) | 12.0 |
需要 PHP 模块 json、simplexml、dom、zlib、gd 以及 mysqlnd 或 pdo_mysql,并建议启用 mbstring。请预留至少 256 MB 的内存限制。
步骤 1:配置 PHP
-
进入 网站与域名,找到您的域名。
-
打开 PHP(或 PHP 设置,取决于您的 Plesk 版本)。
-
选择 PHP 8.3 或更高版本。
-
至少应用以下值:
设置 值 memory_limit256Mupload_max_filesize64Mpost_max_size64Mmax_execution_time30 -
保存。
步骤 2:创建数据库
请按照创建数据库指南创建数据库和专用用户。记下数据库名称、用户名、密码,以及该数据库连接信息中显示的主机名(通常为 localhost)。
您可以从 数据库 页面打开 phpMyAdmin,查看数据库服务器的版本。
步骤 3:下载 Joomla
在官方下载页面获取 .zip 格式的 Full Package。撰写本指南时,最新版本为 6.2.0。
步骤 4:上传并提取文件
- 在 Plesk 中打开 文件,然后进入
httpdocs目录。 - 如果其中有默认页面
index.html,请将其删除。否则,显示的将是该页面,而不是安装向导。 - 上传 Joomla 压缩包。
- 勾选该压缩包,然后点击 提取文件。
- 确认
index.php和installation目录直接位于httpdocs中,而不是在某个子目录中。 - 删除压缩包。
如果您更愿意使用 FTP 客户端(参见更改 FTP 密码),请先在您的计算机上解压压缩包,然后上传其中的内容。
步骤 5:启动安装向导
在浏览器中打开 https://您的域名.com/。如果您的域名还没有有效的 SSL 证书,请暂时使用 http://。
语言和网站名称
选择安装语言,输入网站名称,然后点击 设置登录信息。
超级用户账户
请填写:
- 您的真实姓名;
- 用户名,最好不要使用
admin; - 至少 12 个字符的密码;
- 您能够访问的电子邮件地址,可用于找回账户。
然后点击 设置数据库连接。
数据库
| 字段 | 值 |
|---|---|
| 数据库类型 | MySQLi |
| 主机名 | localhost,或 Plesk 显示的值 |
| 用户名 | 步骤 2 中创建的用户 |
| 密码 | 该用户的密码,而不是超级用户的密码 |
| 数据库名称 | 步骤 2 中创建的数据库 |
| 表前缀 | 保留生成的值,包括末尾的 _ |
| 连接加密 | 保留默认值 |
点击 安装 并等待完成。
完成安装
恭喜! 页面表示安装已完成。您可以在此添加语言,然后通过 完成并打开前台 打开网站,或通过 完成并打开后台 打开管理后台。
Joomla 会自行删除 installation 目录。不过仍请检查 httpdocs:如果该目录仍然存在,请将其删除。
步骤 6:启用友好 URL
此步骤为可选操作,它会将 index.php 从页面地址中去除。
- 在 文件 中打开
httpdocs,将htaccess.txt重命名为.htaccess。 - 登录管理后台,然后打开 系统(System)> 全局配置(Global Configuration)。
- 在 网站(Site)选项卡中,启用 URL 重写(Use URL Rewriting)。
- 保存,然后打开网站的几个页面进行查看。
检查结果
https://您的域名.com/显示您的网站首页。https://您的域名.com/administrator/显示登录页面,并且您的超级用户凭据可以正常登录。httpdocs中已不存在installation目录。- 仪表板未提示有待安装的安全更新。
故障排除
显示 Plesk 默认页面
index.html 文件的优先级高于 index.php。请将其从 httpdocs 中删除或重命名,然后绕过浏览器缓存重新加载页面。
抱歉,PHP 版本不支持。
该域名的 PHP 版本过旧。请在 PHP 中选择 PHP 8.3 或更高版本,然后重新加载页面。
需要 MariaDB ... 或更高版本才能继续安装
数据库服务器不符合此 Joomla 版本的要求。消息中会显示所需版本和当前版本。请通过您的客户区联系技术支持,了解可行的解决方案。
提供的数据库信息不正确 和/或 未填写。
请检查主机名、用户名、密码和数据库名称。请从 Plesk 复制数据库名称,因为它可能带有前缀。
Joomla 要求删除一个文件以确认您是网站所有者
当数据库服务器不在本地时,会出现此验证。如果您的数据库确实位于同一托管空间,请使用 localhost。否则,请从 installation 目录中删除消息里提到的文件,然后重新执行该步骤。
无法删除 "..." 目录。请手动删除该文件夹。
请通过 文件 或 FTP 删除 installation 目录。如果该目录仍然存在,Joomla 可能会将您重新引导到安装向导。
除首页外的所有页面都出现 404 错误
已启用 URL 重写,但 .htaccess 文件不存在或不受支持。请检查文件的确切名称,包括开头的点号。如果问题仍然存在,请在全局配置中停用该选项,并联系技术支持。
创建 .htaccess 后出现 500 错误
请暂时重命名 .htaccess,以确认问题是否由它引起。Joomla 指南提到,Options +FollowSymlinks 这一行在某些服务器上可能导致问题:请尝试在该行开头添加 # 将其注释掉。
空白页面或一般性错误
请查看该域名的 日志 和 administrator/logs 目录。要获取更多详细信息,请在 configuration.php 中暂时将 $error_reporting 设为 'maximum',诊断完成后再改回 'default'。
扩展或文件上传失败
请在 PHP 中增大 upload_max_filesize 和 post_max_size。后者至少应等于前者。