PrestaShop Docker镜像

支持的标签

按PrestaShop版本的镜像

• 8, latest, 8-apache
• 8-fpm
• nightly（来自git的最新但不稳定版本）

可使用这些标签，例如：

bash
docker run -ti --name my-docker-name -e PS_DEV_MODE=false -e PS_INSTALL_AUTO=0 -p 8080:80 -d prestashop/prestashop:8.0

什么是PrestaShop

PrestaShop是一款免费开源的电商Web应用，致力于为商家和客户提供最佳购物车体验。它采用PHP编写，高度可定制，支持所有主要支付服务，已翻译成多种语言并针对多个国家本地化，具有全响应式设计（前后台均支持）等。查看所有可用功能。

[***]

!PrestaShop后台仪表板

如何运行这些镜像

这些镜像基于***PHP仓库的最新版本运行。对于数据库，可使用并链接任何与MySQL兼容的SQL服务器。

若您没有MySQL服务器，运行此容器最简单的方法如下：

bash
# 创建容器通信网络
docker network create prestashop-net
# 启动mysql 5.7容器
docker run -ti --name some-mysql --network prestashop-net -e MYSQL_ROOT_PASSWORD=admin -p 3307:3306 -d mysql:5.7
# 启动prestashop容器
docker run -ti --name some-prestashop --network prestashop-net -e DB_SERVER=some-mysql -p 8080:80 -d prestashop/prestashop:latest

将创建一个新商店，准备安装。

您可通过访问http://localhost:8080使用该商店。

MySQL服务器可通过以下方式访问：

• 从主机使用端口3307（例如：$ mysql -uroot -padmin -h localhost --port 3307）
• 从网络中的容器使用URL some-mysql。

例如，当进入"数据库配置"安装步骤时，安装程序会要求"服务器数据库地址"，输入some-mysql即可。

---

若需自定义容器执行，以下是可用选项：

若您的IP/端口（或域名）在容器两次执行之间发生变化，需修改以下选项：

文档

用户文档（默认英文）可在此处获取。

开发者文档（仅英文）可在此处获取。

故障排除

无法从主机浏览器访问PrestaShop

在Mac或Windows（通过WSL）上使用Docker时，可能无法从主机浏览器访问PrestaShop（重定向到"dockeripaddress:8080"失败）。

Docker for Mac存在桥接网络问题，无法通过内部IP访问容器。安装后，主机浏览器会从http://localhost:8080重定向到http://<prestashop容器内部IP>:8080，导致失败。

需将PS_DOMAIN变量设置为localhost:8080，命令如下：

bash
docker run -ti --name some-prestashop --network prestashop-net -e DB_SERVER=some-mysql -e PS_DOMAIN=localhost:8080 -p 8080:80 -d prestashop/prestashop

无法从主机连接MySQL - 无法加载认证插件

ERROR 2059 (HY000): Authentication plugin 'caching_sha2_password' cannot be loaded: ...

若mysql镜像使用MySQL 8，认证插件从mysql_native_password更改为caching_sha2_password。可通过强制使用旧认证插件解决：

bash
docker run -ti -p 3307:3306 --network prestashop-net --name some-mysql -e MYSQL_ROOT_PASSWORD=admin -d mysql --default-authentication-plugin=mysql_native_password

无法从主机连接MySQL - 无法使用套接字

ERROR 1045 (28000): Access denied for user '...'@'...' (using password: YES)

某些情况下需强制使用TCP而非套接字：

bash
mysql -u root -padmin -h localhost --port 3307 --protocol=tcp

安装过程中PrestaShop无法连接MySQL - 字符集错误

Server sent charset (255) unknown to the client. Please, report to the developers

MySQL 8默认字符集改为utfmb4，部分客户端不支持。需修改MySQL配置文件：

若使用mysql容器，需：

• 修改配置文件/etc/mysql/my.cnf，添加：

[client]
default-character-set=utf8

[mysql]
default-character-set=utf8


[mysqld]
collation-server = utf8_unicode_ci
character-set-server = utf8

• 重启MySQL容器

如何使用构建脚本

更多信息，请阅读HOW-TO-USE.md文件