ECShop是一款基于PHP开发的开源电商系统,以GPL协议开源。ECShop诞生于2006年,是国内最流行的开源商城系统之一,以功能完善、易于二次开发著称。ECShop内置商品管理、订单管理、会员管理、支付接口、物流配送、优惠券、促销活动、文章管理等完整电商功能,支持多种支付方式和配送方式,适合搭建B2C独立商城、品牌官网商城、企业电商平台。
核心优势:完全开源免费、功能完善的电商体系、易于二次开发、丰富的插件和模板生态、支持多种支付接口(支付宝、微信支付、银联等)、SEO友好、轻量快速、国内社区活跃。ECShop是国内中小商家搭建独立商城的首选。
环境要求
- Web服务器:Nginx / Apache / IIS
- PHP版本:PHP 5.6 ~ 7.4(ECShop 4.x推荐PHP 7.2/7.4;注意ECShop对PHP 8+兼容性有限)
- 数据库:MySQL 5.5+ / MariaDB 5.5+
- 内存:最低256MB,推荐512MB以上
- 磁盘:至少200MB可用空间(含商品图片建议1GB以上)
- PHP扩展:mysql、mysqli、gd、curl、mbstring、json、xml、zip、openssl
- PHP配置:allow_url_fopen=On,file_uploads=On
安装教程
步骤1:下载ECShop安装包
cd /www/wwwroot/yourdomain.com
wget https://www.ecshop.com/download/ecshop_4.1.0.zip
unzip ecshop_4.1.0.zip
# 将upload目录内容移到网站根目录
mv upload/* .
rm -rf upload ecshop_4.1.0.zip
注意:请从官网获取最新版本号。ECShop官网可能需要注册下载。
步骤2:创建数据库
mysql -u root -p
CREATE DATABASE ecshop DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'ecshop_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON ecshop.* TO 'ecshop_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
步骤3:配置文件权限
chown -R www:www /www/wwwroot/yourdomain.com
chmod -R 755 /www/wwwroot/yourdomain.com
chmod -R 777 /www/wwwroot/yourdomain.com/data
chmod -R 777 /www/wwwroot/yourdomain.com/images
chmod -R 777 /www/wwwroot/yourdomain.com/temp
chmod 666 /www/wwwroot/yourdomain.com/data/config.php
步骤4:Nginx配置
server {
listen 80;
server_name yourdomain.com www.yourdomain.com;
root /www/wwwroot/yourdomain.com;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/tmp/php-cgi-74.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
# 禁止访问敏感目录
location ~ /(data|temp)/.*\.php$ {
deny all;
}
location ~ /\.ht {
deny all;
}
}
步骤5:运行安装向导
浏览器访问 http://yourdomain.com/install,进入安装页面:
- 阅读许可协议,点击”下一步”
- 环境检测页面,确认所有检测项通过(PHP版本、MySQL扩展、GD库、目录权限等)
- 填写数据库配置:数据库主机(localhost)、数据库名、用户名、密码、表前缀(ecs_)
- 填写管理员信息:管理员账号、密码、邮箱
- 填写商店信息:商店名称、商店URL
- 点击”立即安装”,等待安装完成
步骤6:删除安装目录并登录后台
rm -rf /www/wwwroot/yourdomain.com/install
# 安全建议:重命名admin目录
mv /www/wwwroot/yourdomain.com/admin /www/wwwroot/yourdomain.com/myadmin
访问 http://yourdomain.com/myadmin 登录后台管理面板。ECShop后台功能包括:商品管理、订单管理、会员管理、促销管理、文章管理、广告管理、权限管理、系统设置、模板管理、插件管理等。
Windows环境安装(phpStudy集成环境)
- 下载安装phpStudy(https://www.xp.cn),开启Apache/Nginx和MySQL(PHP选择7.2或7.4)
- 从ECShop官网(https://www.ecshop.com)下载安装包,解压upload目录到WWW目录
- 打开phpMyAdmin创建数据库
- 设置data、images、temp目录权限为777,data/config.php为666
- 浏览器访问http://localhost/ecshop/install运行安装向导
- 完成安装后删除install目录,重命名admin目录
宝塔面板安装(推荐)
- 安装宝塔面板,登录后一键安装LNMP环境(Nginx + MySQL + PHP 7.4)
- 点击”网站” → “添加站点”,填写域名,创建数据库
- 在网站根目录下载并解压ECShop安装包,将upload目录内容移到根目录
- 设置data、images、temp目录权限为755,所有者为www;data/config.php为644
- 浏览器访问域名/install运行安装向导
- 填写数据库信息和管理员账号完成安装
- 删除install目录,重命名admin目录,登录后台配置商城
服务器配置建议
- PHP版本:推荐PHP 7.4(ECShop对PHP 8+兼容性有限,不建议使用)
- PHP内存限制:
memory_limit = 128M(推荐256M) - 上传文件大小:
upload_max_filesize = 32M,post_max_size = 32M - 最大执行时间:
max_execution_time = 60 - 启用OPcache加速
- 配置Redis或Memcached缓存(需安装ECShop缓存插件)
- 商品图片目录(images)建议单独挂载或定期备份
- 配置CDN加速静态资源和商品图片
- 定期备份数据库和images、data目录
- 关注ECShop官方安全更新,及时升级补丁
- 生产环境务必重命名admin目录,修改默认表前缀
常见问题
Q:安装时提示”目录不可写”?
A:执行chmod -R 777 data images temp和chmod 666 data/config.php,确保文件所有者为www用户。
Q:PHP 8环境下ECShop报错?
A:ECShop官方版本对PHP 8+兼容性有限,建议使用PHP 7.2或7.4。如需PHP 8,可寻找社区维护的兼容版本或自行修改代码。
Q:后台登录后自动退出或验证码不显示?
A:检查PHP的session.save_path是否正确且可写,检查GD库是否安装启用,检查data/session目录权限。
Q:商品图片上传失败?
A:检查images目录权限是否为777,检查PHP的upload_max_filesize设置,检查PHP的file_uploads是否开启,检查磁盘空间是否充足。
Q:忘记管理员密码?
A:数据库执行:UPDATE ecs_admin_user SET password=MD5('新密码'), salt='' WHERE user_id=1;(ecs_替换为你的表前缀)
Q:支付接口如何配置?
A:在后台”系统设置” → “支付方式”中启用对应支付插件,填写商户号、密钥等信息。支付宝和微信支付需要先申请商户账号。
官方网址
ECShop官网地址:https://www.ecshop.com