WP商城WooCommerce搭建:从零开始:在宝塔面板搭建
前置准备
在开始 WP商城WooCommerce搭建 之前,你需要准备以下内容:
- 一台云服务器(推荐2核4G以上,Linux系统,如CentOS 7或Ubuntu 20.04)
- 一个已解析到服务器IP的域名(备案状态按国内要求确认)
- 宝塔面板(已安装并登录)
- PHP版本:推荐7.4或8.0(需安装fileinfo、opcache、redis等扩展)
- 数据库:MySQL 5.7或MariaDB 10.3+(建议同步安装phpMyAdmin)
- Nginx 或 Apache(本文以Nginx为例)
如果你还没有安装宝塔面板,可以参考宝塔官网的一键安装脚本。
分步操作
第一步:在宝塔创建站点
登录宝塔面板,点击左侧“网站” -> “添加站点”。
- 域名:输入你的域名(如
shop.example.com) - 根目录:保持默认(如
/www/wwwroot/shop.example.com) - 数据库:选择“创建MySQL数据库”,填写用户名和密码,保存记录
- PHP版本:选择7.4或8.0
- 其他:勾选“FTP”以便后续上传文件(可跳过)
点击“提交”,宝塔会自动生成站点目录和数据库。
第二步:安装WordPress
- 访问你的域名,WordPress安装引导页会自动出现。
- 选择语言为中文简体,点击“继续”。
- 填写数据库信息(数据库名、用户名、密码、数据库主机一般填
localhost,表前缀保持wp_)。 - 点击“提交”,然后运行安装程序。
- 填写站点标题、管理员用户名、密码、邮箱,点击“安装WordPress”。
安装完成后,你会自动登录到WordPress后台。
第三步:安装WooCommerce插件
- 在WordPress管理侧栏,点击“插件” -> “安装插件”。
- 在搜索框输入“WooCommerce”,找到第一个插件(图标是购物车),点击“现在安装”。
- 安装完成后点击“启用”。
WooCommerce会自动启动安装向导(如果没看到,可以在左侧“WooCommerce”菜单中找到)。
第四步:配置WooCommerce基础设置
按照向导步骤完成:
- 商店详情:设置商店地址、货币(人民币CNY)、商品计量单位等。
- 支付方式:推荐先启用“银行转账”和“货到付款”测试,后续再接入微信/支付宝。
- 配送方式:添加“统一运费”并设置金额。
- 推荐的插件:可以跳过,后续按需安装。
- 主题选择:建议选一个免费的WooCommerce兼容主题(如Storefront),点击“安装并激活”。
完成后,你就可以在“产品” -> “添加新品”中上传商品了。
# 可选:为了优化国内访问,可以在宝塔面板中开启Redis缓存(安装Redis扩展并安装WP-Redis插件)避坑指南
- 问题1:安装WooCommerce时提示“需要更高级的PHP内存限制”
解决办法:在宝塔面板 -> 软件商店 -> PHP设置 -> 配置修改,将 memory_limit 改为 256M 或更高,保存后重载PHP。
- 问题2:前台页面404或空白
大概率是伪静态设置问题。
在宝塔“网站” -> 选择你的站点 -> “设置” -> “伪静态” -> 选择“wordpress”,保存。
- 问题3:WooCommerce后台无法加载或报错“cURL error”
检查服务器是否禁用了 curl 和 openssl 扩展。
在宝塔面板PHP管理中找到并启用这两个扩展。
高频问题解答
Q:WP商城WooCommerce搭建后如何配置HTTPS?
A:在宝塔面板“网站” -> 你的站点 -> “SSL”中申请Let's Encrypt免费证书并开启强制HTTPS。
然后在WordPress后台“设置”->“常规”中将WordPress地址和站点地址改为https。
Q:WooCommerce商品图片上传失败怎么办?
A:检查PHP上传大小限制。
在宝塔面板PHP设置中将 upload_max_filesize 和 post_max_size 改为 64M,同时修改Nginx配置中的 client_max_body_size 为 64M。
Q:订单支付后状态不更新?
A:检查WooCommerce设置中的“支付完成页”配置,并确保安装了可靠的支付插件(如支付宝官方插件)。
此外,检查WordPress固定链接是否为“文章名”格式,并刷新伪静态规则。
效果验证
- 访问前台:打开你的域名,应看到默认的WooCommerce商店页面(包含示例商品或你添加的商品)。
- 添加测试商品:在后台“产品”->“添加新品”,填写价格和图片,发布。前台应能看到该商品详情。
- 模拟下单:以一个低价虚拟商品(如1元)为例,选择商品加入购物车,进入结算页,填写地址并选择货到付款,提交订单。在后台“WooCommerce”->“订单”中查看是否出现新的订单记录。
- 检查支付回调:如果配置了在线支付,测试一笔真实支付(可用0.01元),确认订单状态自动变为“处理中”。
以上步骤全部成功,说明你的 WP商城WooCommerce搭建 已顺利完成。
如果你在搭建过程中遇到其他问题,建议优先检查宝塔面板的错误日志(“软件商店”->“运行环境”->“Nginx”->“错误日志”),根据日志关键词搜索解决方案。