在 Plesk 上安装 PrestaShop
在您的 Plesk 托管空间上安装 PrestaShop:PHP 配置、数据库、文件上传、安装向导、后台访问以及常见错误的解决方法。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南介绍如何使用官方安装包在您的 Plesk 托管空间上安装 PrestaShop,然后确认商店及其后台运行正常。
前提条件
- 能够访问您的 Plesk 面板(参见连接到 Plesk 界面)。
- 一个已绑定到您的托管空间并指向该空间的域名。
- 一个空的
httpdocs目录;如果其中已有网站,请先备份。
本指南使用 httpdocs,这是主域名通常使用的目录。附加域名的目录可能不同:请在 主机与 DNS > 主机 中查看 文档根目录。
以下是 PrestaShop 9 的官方要求,这是撰写本指南时的当前版本分支。安装其他版本前,请在 PrestaShop 文档中进行核实。
| 项目 | 要求 |
|---|---|
| PrestaShop 9.1 和 9.2 的 PHP 版本 | 8.1 至 8.5,推荐 8.5 |
| PrestaShop 9.0 的 PHP 版本 | 8.1 至 8.4,推荐 8.4 |
| 数据库 | 最低 MySQL 5.7 或 MariaDB 10.2,建议使用较新版本 |
memory_limit |
最低 512M |
allow_url_fopen |
启用 |
| PHP 扩展 | cURL、DOM、Fileinfo、GD、Iconv、Intl、JSON、Mbstring、OpenSSL、PDO、PDO MySQL、SimpleXML、Zip |
步骤 1:配置 PHP
- 进入 网站与域名,找到您的域名。
- 打开 PHP(或 PHP 设置,取决于您的 Plesk 版本)。
- 选择兼容的 PHP 版本。
- 将
memory_limit设为512M,并启用allow_url_fopen。 - 保存。
通过 查看 phpinfo() 页面 链接,可以检查已生效的值和已加载的扩展。
步骤 2:创建数据库
请按照创建数据库指南创建数据库和专用用户。请准确记下:
- 数据库名称;
- 用户名;
- 密码;
- 数据库服务器地址,可在该数据库的连接信息中找到(通常为
localhost)。
步骤 3:下载 PrestaShop
-
前往官方下载页面,获取可直接使用的安装包。
-
在您的计算机上解压该压缩包。其中包含以下文件:
文本index.php prestashop.zip Install_PrestaShop.html
步骤 4:上传文件
- 在 Plesk 中打开 文件,然后进入
httpdocs目录。 - 如果其中有默认页面
index.html,请将其删除。否则,显示的将是该页面,而不是安装向导。 - 上传
index.php和prestashop.zip。无需上传Install_PrestaShop.html文件。
您也可以使用 FTP 客户端上传这些文件(参见更改 FTP 密码)。
步骤 5:启动安装向导
在浏览器中打开 https://您的域名.com/。index.php 文件会自动解压 prestashop.zip,然后启动向导。如果您的域名还没有有效的 SSL 证书,请暂时使用 http://。
然后按照各个页面操作:
- 选择语言(Choose your language):选择安装语言。
- 许可协议(License agreements):阅读并接受相关条款。
- 系统兼容性(System compatibility):向导会检查您的环境。请修复提示的问题,然后重新检查。
- 商店信息(Store information):填写商店名称、经营类别、所在国家/地区,以及管理员账户的姓名、电子邮件地址和密码。请选择一个足够安全且仅用于本网站的密码。
- 商店内容(Content of your store):选择是否安装演示商品。它们有助于了解该软件,但对于正式运营的商店没有必要。
- 系统配置(System configuration):输入步骤 2 中记下的服务器地址、数据库名称、用户名和密码。如有需要,可更改表前缀
ps_,然后运行连接测试。 - 商店安装(Store installation):请耐心等待,不要关闭页面,直到出现最终页面。
步骤 6:完成安装并加强安全
记下后台地址
安装结束时,PrestaShop 会自动将 admin 目录重命名为一个唯一的名称,由 admin 加上数字和字母组成。该名称是后台地址的一部分:
https://您的域名.com/admin123abcdefghijklmnop/请使用最终页面上的链接,将此地址加入书签并妥善保存。如果遗失,可通过文件管理器在 httpdocs 中找到该目录。
确认 install 目录已删除
较新的版本(包括 9.2.1)会尝试自行删除此目录,即使最终页面仍提示您手动删除。请打开 httpdocs:如果 install 目录仍然存在,请将其删除。保留该目录会使您的商店面临安全风险。
如果 prestashop.zip 仍然存在,也请将其删除。
检查结果
- 打开
https://您的域名.com/:应显示商店首页。 - 打开后台地址,并使用管理员账户登录。
- 确认
https://您的域名.com/install/不再显示安装向导。 - 浏览一个商品页面,然后将商品加入购物车。
故障排除
显示 Plesk 默认页面
index.html 文件的优先级高于 index.php。请将其从 httpdocs 中删除或重命名,然后绕过浏览器缓存重新加载页面。
自动解压失败或卡住
在 文件 中勾选 prestashop.zip,点击 提取文件 将其解压到 httpdocs,然后打开 https://您的域名.com/install/。同时请确认可用磁盘空间充足。
兼容性步骤报告错误
消息中会指出有问题的扩展或设置。请在 PHP 中进行修正,然后重新检查。如果无法从面板启用该扩展,请联系技术支持。
Database Server is not found. Please verify the login, password and server fields
请检查服务器地址、用户名和密码。依次尝试 localhost、127.0.0.1,或 Plesk 显示的完整值,并按 host:port 格式附上端口。
Connection to MySQL server succeeded, but database "..." not found
数据库名称不正确。请从 Plesk 的 数据库 页面准确复制该名称,因为它可能带有前缀。
At least one table with same prefix was already found
数据库中已存在使用此前缀的表。请选择其他前缀或使用空数据库。只有在确认现有的表未被其他网站使用后,才可将其删除。
The admin folder could not be renamed into ...
PrestaShop 无法重命名 admin 目录。请确认不存在同名目录,并且 httpdocs 的权限正确;如果问题仍然存在,请联系技术支持。
500 错误或空白页面
请查看该域名的 日志 以及 PrestaShop 的 var/logs 目录,然后检查 memory_limit 的值。如果您可以进入后台,调试模式位于 高级参数(Advanced Parameters)> 性能(Performance)。诊断完成后请将其关闭。
商品页面返回 404 错误
友好 URL 依赖 .htaccess 文件。请在后台打开 SEO 和 URL 设置(Shop Parameters > Traffic & SEO),然后保存以重新生成该文件。如果错误仍然存在,请向技术支持确认您的域名是否支持 .htaccess 规则。
找不到后台
安装后 /admin 地址不再可用,这是正常现象。请在 httpdocs 中查找名称以 admin 开头的目录,然后将该名称加到您的网站地址后面。