爱之谷ECShop私密商城PHP源码二次开发与隐私发货改造

简介：这套爱之谷成人用品商城整站模板面向使用 ECShop v2.7.3 搭建垂直电商站点的开发者与站长，提供一套带整站数据的php源码方案，适合具备基础PHP与ECShop使用经验、希望研究商城模板结构、页面组织与数据配套方式的读者参考，也可用于同类商城项目的本地学习。压缩包共3个文件，包含zip模板包、sql数据库文件及htm说明文档，分别对应主题文件、站点数据与使用说明，整体约18.36MB，目录与数据组织相对完整。发布以来已有2751人学习下载，具备一定参考基础。读者可从中获得整站模板文件、配套数据库数据及说明材料，便于分析ECShop模板的页面构成、数据表结构和前后台组织方式，并对模板目录层级、模块划分形成直观认识，作为二次开发与本地测试的参考样本。

1. 私密品类独立站为何还在用 ECShop：这套「爱之谷」整站 php源码 能解决什么

前阵子帮朋友接了个小活，他要做一个只卖私密品类的小商城，预算不高、工期两周，聊了几家 SaaS 都卡在两个点上：商品详情页要能自定义“尺码 / 材质 / 包装说明”这组属性，订单还要能标记“隐私发货”。最后从资源包里翻出来的底座，就是这套「爱之谷成人用品商城整站 for ECshop v2.7.3」，一份完整可部署的 php源码，前后台齐全，商品、分类、属性模板、订单、支付插件、主题模板全在里面。ECShop v2.7.3 不是什么新框架，但模板机制直白、目录结构一眼能看穿、改一行刷新就能看到效果，对小商城外包和想拿它当 PHP 电商样本读源码的人都够用。下面按“先看结构、再跑起来、最后动手改”的顺序拆一遍。

2. 目录结构与请求链路：一次商品详情请求到底经过了哪些文件

ECShop 这类老框架最大的好处是“没有黑匣子”：你打开浏览器敲一个 URL，中间经过哪几个 PHP 文件、哪个模板、哪几条 SQL，都能顺着目录找出来。先看整体结构，再看一条完整链路，后面改模板、加字段时心里才有数。

2.1 顶层目录：哪些是核心，哪些可以整目录删

解压之后顶层会看到一堆平铺的 PHP 入口文件，这是 ECShop 典型的“一个页面一个入口”的写法，和现在流行的单一入口 MVC 完全不是一个路子。第一次看会觉得乱，但好处是找功能特别快——想知道分类页怎么渲染，直接打开category.php。

值得单独说一句的是includes/下面这几块：init.php是所有入口的公共引导，负责加载配置、连库、初始化模板对象；cls_mysql.php是对mysql_*系列函数的一层薄封装，后面踩坑章会重点讲它；cls_template.php是套在 Smarty 2 外面的一层壳，负责把.dwt编译成 PHP 再include；lib_main.php里放着一堆前台公共函数，比如取分类树、取推荐位。这几个文件基本决定了整个站点的行为边界。

注意：install/目录装完不删，等于把数据库重装入口挂在公网上，这是最常见的一类翻车。

2.2 一个商品详情请求从入口脚本到模板渲染的链路

打开goods.php会看到非常线性的流程：接收id参数、初始化、查商品、查属性、查关联分类、组装模板变量、输出。真正有价值的是中间“查商品”那一段，因为它决定了你后面能不能往详情页塞自定义字段。下面这段是这类入口脚本的典型骨架，参数和调用顺序跟实际文件基本一致：

<?php // goods.php 精简骨架，只保留链路关键步骤 define('IN_ECS', true); require dirname(__FILE__) . '/includes/init.php'; // 连库、配置、模板对象都在这里初始化 $goods_id = isset($_GET['id']) ? intval($_GET['id']) : 0; if ($goods_id <= 0) { ecs_header("Location: index.php\n"); exit; } // 1. 主表：商品本身 $goods = $db->getRow("SELECT * FROM {$ecs->table('goods')} WHERE goods_id = '$goods_id' AND is_delete = 0 AND is_on_sale = 1"); // 2. 属性表：详情页的尺码/材质/包装说明都来自这里 $attr_list = $db->getAll("SELECT a.attr_id, a.attr_name, ga.attr_value, ga.attr_price FROM {$ecs->table('goods_attr')} AS ga LEFT JOIN {$ecs->table('attribute')} AS a ON a.attr_id = ga.attr_id WHERE ga.goods_id = '$goods_id' ORDER BY a.attr_id ASC"); // 3. 相册与扩展字段，模板里按下标取 $goods['gallery'] = $db->getAll("SELECT img_url, thumb_url FROM {$ecs->table('goods_gallery')} WHERE goods_id = '$goods_id' ORDER BY img_id ASC"); $smarty->assign('goods', $goods); $smarty->assign('attr_list', $attr_list); $smarty->assign('goods_id', $goods_id); $smarty->display('goods.dwt'); // 交给模板层，实际文件在 themes/<当前主题>/goods.dwt

这段代码有三个点值得留意。第一，$ecs->table('goods')是表前缀拼接函数，实际表名是ecs_goods，写 SQL 时永远走它，别硬写前缀，否则换前缀就全废。第二，is_on_sale = 1和is_delete = 0是软删除与上架状态的双保险，二次开发时如果做了“隐藏分类”，记得在这里同步加条件，不然隐藏分类的商品还能通过直链访问到。第三，$smarty->display('goods.dwt')传的是文件名不是路径，真正的路径由cls_template.php根据当前主题去themes/下拼，这也是为什么换主题只要改后台一个配置项。

2.3 数据表落点：商品、属性、订单三张主表怎么串

改代码之前先把三张表的关系理清楚，能省掉大量“字段到底存在哪”的来回翻查。ECShop 的商品属性不是存在商品表里的 JSON，而是标准的三表结构：ecs_goods_type定义“属性模板”（比如“成人用品通用属性”），ecs_attribute定义具体属性名（尺码、材质、包装方式），ecs_goods_attr存每个商品的实际值。商品表ecs_goods只用一个goods_type字段指向模板 ID。

-- 查某个商品的全部属性，二次开发时最常用的一条 SQL SELECT g.goods_id, g.goods_name, g.goods_sn, g.shop_price, g.goods_number, a.attr_name, ga.attr_value, ga.attr_price FROM ecs_goods AS g LEFT JOIN ecs_goods_attr AS ga ON ga.goods_id = g.goods_id LEFT JOIN ecs_attribute AS a ON a.attr_id = ga.attr_id WHERE g.goods_id = 100 AND g.is_delete = 0;

订单侧是ecs_order_info（一单一行，含order_sn、consignee、tel、postscript备注、order_amount）加ecs_order_goods（一单一商品多行）。做“隐私发货”标记时，最省事的做法不是改表，而是复用postscript备注字段，用一个固定前缀约定，比如[PRIVATE]，后台列表和打印面单时按前缀判断；要做得更正规，就在ecs_order_info上加一个is_private的tinyint字段，改动量也不大，后面第 3 章会给具体写法。

3. 模板层改造：详情页规格、18+ 门槛与隐私发货提示怎么落

真正让这类商城“能用”的不是后台功能，而是前台页面上那几个细节：属性要排得清楚、进站要有年龄确认、下单要让用户看得见“隐私发货”这四个字。这一章全部落在模板和前台逻辑上，改完刷新就能验证。

3.1 模板覆盖机制：改themes下的.dwt，别碰根目录

ECShop 的模板文件后缀是.dwt，语法是 Smarty 2 的老写法，循环用 HTML 注释包起来，这一点和新版 Smarty 差别很大，第一次改容易写错。定位规则很简单：后台“模板管理”里选中的主题名，对应themes/<主题名>/目录，详情页就是goods.dwt，分类页是category.dwt，下单流程是flow.dwt。改之前建议先整目录复制一份改名，比如themes/privateshop/，在后台切过去，这样原始主题还在，改崩了能一键回滚——这条血泪经验值一次通宵。

<!-- themes/privateshop/goods.dwt 详情页主体片段 --> <div class="goods-info"> <h1>{$goods.goods_name}</h1> <p class="price">{$goods.shop_price}</p> <!--{if $attr_list}--> <dl class="attr-box"> <!--{foreach from=$attr_list item=attr}--> <dt>{$attr.attr_name}</dt> <dd>{$attr.attr_value}<!--{if $attr.attr_price}-->（+{$attr.attr_price}）<!--{/if}--></dd> <!--{/foreach}--> </dl> <!--{/if}--> <div class="privacy-tip">本商品默认隐私包装发货，面单不体现商品名称</div> </div>

模板里{$goods.goods_name}直接对应 2.2 节assign('goods', $goods)里的数组键，<!--{foreach}-->是 Smarty 2 的循环标签，注意是 HTML 注释形式，写成{foreach}不会被解析。$attr.attr_price有值时追加加价，这一手在私密品类里很实用，比如“加急隐私包装 +10 元”。

3.2 属性体系落地：把“尺码 / 材质 / 包装”做成可复用模板

很多人在后台一个个商品手填属性，填到第二十个就崩溃了。正确姿势是用ecs_goods_type做属性模板：新建一个“私密品类通用属性”，把尺码、材质、包装方式、是否可退换全部挂上去，之后每个商品只要选中这个模板，属性项自动出现，只填值就行。这一步是纯后台操作，不写代码，但决定了后面详情页模板能不能一套通用。

要对已有商品批量补属性，可以走一段一次性脚本，注意执行完立刻删掉：

<?php // 一次性脚本：给指定分类下所有商品补“包装方式”属性，跑完必须删除 define('IN_ECS', true); require dirname(__FILE__) . '/includes/init.php'; $cat_id = 12; // 目标分类 ID $attr_id = 8; // “包装方式”在 ecs_attribute 里的 ID $value = '隐私包装'; // 统一填充值 $sql = "SELECT goods_id FROM {$ecs->table('goods')} WHERE cat_id = '$cat_id' AND is_delete = 0"; foreach ($db->getAll($sql) as $row) { $exists = $db->getOne("SELECT COUNT(*) FROM {$ecs->table('goods_attr')} WHERE goods_id = '{$row['goods_id']}' AND attr_id = '$attr_id'"); if (!$exists) { $db->query("INSERT INTO {$ecs->table('goods_attr')} (goods_id, attr_id, attr_value, attr_price) VALUES ('{$row['goods_id']}', '$attr_id', '$value', '0')"); } } echo 'done';

参数就三个：cat_id限定范围、attr_id指定属性、value填值。$exists判断是防重复插入的关键，这类脚本最容易犯的错就是跑两遍导致属性重复显示两行。生产环境务必先用一个测试分类跑通再全量。

3.3 18+ 年龄确认与隐私发货提示：前端弹层加服务端兜底

年龄确认这件事，前端弹层是体验，服务端判断才是底线。纯靠 JS 的弹层，用户清个 Cookie 就绕过去了；但你也别指望做实名，成本太高，实际项目里通常就是“Cookie 记一年 + 关键页服务端校验一次”。

// static/js/age-gate.js：进站弹层，确认后写 Cookie 一年 (function () { var KEY = 'age_confirmed'; if (document.cookie.indexOf(KEY + '=1') > -1) return; var mask = document.createElement('div'); mask.className = 'age-mask'; mask.innerHTML = '<div class="age-box"><p>本商城仅面向成年人开放</p>' + '<button id="age-yes">我已满 18 周岁</button>' + '<a href="https://www.example.com">离开</a></div>'; document.body.appendChild(mask); document.getElementById('age-yes').onclick = function () { // 一年有效期，path=/ 保证全站生效 document.cookie = KEY + '=1; max-age=31536000; path=/'; mask.remove(); }; })();

配套的服务端兜底放在详情页入口，成本很低：

// 加在 goods.php 的 $goods_id 校验之后 if (empty($_COOKIE['age_confirmed'])) { // 未确认就回首页并带上提示参数，由首页模板渲染弹层 ecs_header("Location: index.php?age_gate=1\n"); exit; }

注意别把这段加到后台或支付回调入口上，否则回调请求没 Cookie 会被直接踢走，支付就“付了不到账”——这是很典型的一次翻车现场。隐私发货提示则简单得多，直接在goods.dwt和下单页flow.dwt各放一段固定文案即可，关键是文案要和后台订单标记对得上，别前台写“隐私包装”、仓库按普通件发。

3.4 下单链路改造：flow.php里把隐私发货标记写进订单

flow.php是整个站最值得读的文件，它用step参数串起“购物车 → 收货人 → 配送支付 → 完成”四步，用act参数处理加购、改数量、删除。要加隐私发货，最干净的做法是加一个订单字段，而不是塞备注。

-- 给订单表加一个隐私发货标记，默认 0 ALTER TABLE ecs_order_info ADD COLUMN is_private TINYINT(1) NOT NULL DEFAULT 0;

// flow.php 下单落库那一段，加上 is_private $is_private = isset($_POST['is_private']) ? intval($_POST['is_private']) : 0; $sql = "INSERT INTO {$ecs->table('order_info')} (order_sn, user_id, order_status, shipping_status, pay_status, consignee, address, tel, postscript, is_private, goods_amount, order_amount, add_time) VALUES ('$order_sn', '$user_id', '0', '0', '0', '$consignee', '$address', '$tel', '$postscript', '$is_private', '$goods_amount', '$order_amount', '" . gmtime() . "')"; $db->query($sql); $order_id = $db->insert_id();

字段加完之后还有三处要跟着改，否则功能只完成一半：后台订单列表order_list模板加一列显示标记；打印发货单的模板里按is_private决定是否打印商品名；订单导出 SQL 带上这个字段给仓库。三处都改完，这条链路才算闭环。

4. 部署跑通：从空服务器到前后台能下单

这套源码是基于老版本 PHP 写的，直接丢到 PHP 8 环境里会当场报错。想少折腾，环境就先按它的舒适区来，跑通之后再考虑升级改造。

4.1 环境版本与扩展：PHP 5.6 是舒适区

PHP 5.6 现在很多面板默认不提供，需要自己编译或者用容器起一个。用 Docker 的话一条命令就能拉起来，比在宿主机上来回降级干净得多：

# 起一个 PHP 5.6 + Apache 的环境，把站点目录挂进去 docker run -d --name ecshop \ -p 8080:80 \ -v /data/www/privateshop:/var/www/html \ php:5.6-apache # 进容器装 mysql 扩展，这是老代码的命门 docker exec -it ecshop docker-php-ext-install mysql gd docker restart ecshop

-v挂载的是解压后的站点根目录，-p 8080:80把容器 80 映射到宿主机 8080，改完代码不用重启容器，直接刷新浏览器。装扩展那一步别省，mysql不装，首页第一行就是致命错误。

4.2 安装向导、导入 SQL 与data/config.php

浏览器访问http://你的地址/install/，跟着向导走：环境检测 → 填数据库信息 → 建表导数据 → 设置管理员账号 → 完成。有两个细节向导不会提醒你：一是数据库字符集选utf8而不是utf8mb4，老代码里的字段长度按utf8设计的，换utf8mb4在某些表上会超长；二是安装完成后data/config.php会被写入数据库连接信息，这个文件之后要备份，迁移服务器时直接改它比重新装一遍快得多。

<?php // data/config.php 关键几行，迁移时只改这里 $db_name = 'privateshop'; // 数据库名 $db_user = 'shop_user'; // 账号，别用 root $db_pass = '改成你的密码'; $db_host = '127.0.0.1'; $db_prefix = 'ecs_'; // 表前缀，装完别随意改，所有 SQL 都依赖它

装完之后第一件事是删install/目录，第二件事是把data/下写入的安装锁文件也清掉，否则某些版本会提示重复安装。然后访问前台首页，能看到模板渲染出来的页面，说明temp/编译正常；如果页面白屏但没报错，八成是temp/不可写，模板编译失败被静默吞掉了。

4.3 伪静态、目录权限与后台入口改名

伪静态配不好，分类页和详情页的 URL 会退化成一串参数，对搜索收录很不友好。Nginx 下的规则大致如下，放到站点的server块里：

# ECShop 伪静态，注意最后一条兜底要放在静态资源之后 location / { if (!-e $request_filename) { rewrite ^/category-([0-9]+)-([0-9]+)\.html$ /category.php?id=$1&page=$2 last; rewrite ^/goods-([0-9]+)\.html$ /goods.php?id=$1 last; rewrite ^/article-([0-9]+)\.html$ /article.php?id=$1 last; } }

规则写完记得在后台的 URL 重写开关里打开对应选项，两边不一致会出现“规则生效了但生成的链接还是老的”这种诡异情况。目录权限方面，data/、temp/、images/三个目录要可写，其余目录一律只读，这条在共享主机上尤其重要：

# 只给必要目录写权限，PHP 文件保持只读，降低被写入的风险 chmod -R 755 /data/www/privateshop chmod -R 777 /data/www/privateshop/data /data/www/privateshop/temp /data/www/privateshop/images chmod 644 /data/www/privateshop/data/config.php

后台目录默认叫admin，装完第一件事就是改名，比如manage_xxxx，然后同步修改data/config.php里对应配置。这一步花两分钟，能挡掉绝大部分后台扫描脚本。

4.4 跑通验收清单：前台能加购、后台能看单

部署完别急着交付，按这条线走一遍：前台首页打开 → 分类页翻页正常 → 详情页属性显示完整 → 加入购物车 → 提交订单（不支付）→ 后台订单列表能看到这单 → 后台点“确认订单”状态变化 → 前台会员中心能看到订单。这条线走通，说明模板、数据库、会话、权限四条链路都没问题。

再把隐私发货标记验一遍：下单时勾选隐私发货 → 后台订单详情能看到标记 → 打印发货单不出现商品名称。这一步是这类商城和普通商城的分水岭，验收时一定要走。

5. 避坑与排查：老框架跑新需求最容易翻车的五个点

这一章全是实际部署时踩出来的，每条按“看到什么现象 → 为什么 → 怎么解决”写，遇到同类问题可以直接对照。

5.1 首页满屏mysql_connect() undefined function

现象：代码传到 PHP 7.x 环境，首页第一行就报Call to undefined function mysql_connect()，后面跟着一串cls_mysql.php的报错。

原因：PHP 7.0 起mysql_*系列函数被彻底移除，而这套代码的数据库层includes/cls_mysql.php就是包着这组函数写的，等于地基没了。

解决：最稳的是把环境降到 PHP 5.6，装mysql扩展，十分钟搞定。如果非要在 PHP 7 上跑，就得把cls_mysql.php里的mysql_connect、mysql_query、mysql_fetch_assoc等逐个换成mysqli_*或 PDO 版本，改动面覆盖整个文件，还要注意mysql_real_escape_string没有直接对应物，建议直接上 PDO 重写这一层，别做半吊子替换。

5.2 模板改完刷新没反应，改的内容像被吞了

现象：themes/下的.dwt明明改了，浏览器刷新还是老样子，清浏览器缓存也没用。

原因：ECShop 会把.dwt编译成 PHP 缓存在temp/目录，文件名是编译后的哈希，模板更新时间判断在某些版本上不灵敏，尤其是服务器时间和文件时间不一致时。

解决：先手动清temp/下的编译文件（保留目录本身），再刷新。后台一般有个“清空缓存”的按钮，点一下等效。如果清了还不生效，检查后台当前选中的主题名是不是你以为的那个——切主题后模板路径就变了，改错目录的情况非常常见。

5.3 商品图上传成功但前台显示裂图

现象：后台提示上传成功，文件也能在服务器上找到，前台<img>却是裂的。

原因：两种可能。一是images/目录权限不对，缩略图生成失败但错误被吞了；二是后台配置的“站点地址”还是安装时的localhost，前台拼出来的图片 URL 指向了错误域名。

解决：先看images/下有没有生成对应尺寸的缩略图文件，没有就是gd扩展没装或目录不可写；有缩略图但前台裂，就去后台商店设置里把站点 URL 改成实际访问域名，改完清一次缓存。

5.4 支付回调收不到，用户付了钱订单还是“未支付”

现象：支付页面能跳转、能付钱，回来订单状态不变，后台也查不到回调记录。

原因：根目录的respond.php是第三方支付异步通知的统一入口，但它经常被伪静态规则误伤——if (!-e $request_filename)这类兜底规则如果写在它前面，回调请求会被重写到别的页面去；另一种情况是站点开了强制 HTTPS 或防火墙拦截了外部 POST。

解决：先把伪静态规则里respond.php显式排除，location = /respond.php { try_files $uri =404; }这种写法放到最前面；再去看服务器访问日志里有没有回调请求进来，有请求但没处理，就是支付插件配置的商户参数对不上；完全没请求，那就是网络层被挡了。

5.5 订单备注里的标记被过滤，隐私发货没生效

现象：下单时填了隐私发货，后台订单里看不到标记，或者标记变成空字符串。

原因：订单备注走的是表单提交，ECShop 在入库前会对postscript做一轮过滤，某些特殊字符会被清掉；如果你是用前缀约定的方式做标记，前缀恰好被过滤掉就全丢了。

解决：不要依赖备注字段做业务标记，老老实实加独立字段（见 3.4 节），字段值是0/1，过滤逻辑碰不到它。已经上线的站要兼容历史数据，可以在读取时做一次兜底：is_private为 0 但postscript含约定前缀的，按隐私单处理。

6. 二次开发：把属性、SEO 和后台运营拆开的改造思路

这套源码最容易越改越乱的地方，是所有逻辑都往模板里塞。我的做法是先定一条界线：模板只负责展示，业务规则全部收到includes/lib_*.php里。比如“哪些分类不显示在导航”“哪些商品需要年龄确认”，这类判断写成函数放在lib_main.php，模板里只调一次函数，后面规则变了改一处就够。

第二个改造点是 SEO。私密品类的搜索流量基本靠长尾词，而 ECShop 默认的标题规则是“商品名 - 站点名”，太单薄。可以在详情页入口加一段拼接逻辑，把属性值、分类名、适用人群组合进keywords和description：

// 放在 goods.php 的 assign 之前，把属性值拼进 SEO 字段 $seo_words = array(); foreach ($attr_list as $a) { if (in_array($a['attr_name'], array('材质', '尺码', '包装方式'))) { $seo_words[] = $a['attr_name'] . $a['attr_value']; } } $smarty->assign('meta_keywords', $goods['goods_name'] . ',' . implode(',', $seo_words));

第三个改造点是后台运营效率。仓库最关心的是“这单要不要特殊包装”，所以后台订单列表必须一眼能看到标记，别让人点进详情页去找。给列表页加一列、给导出 SQL 加字段、给打印模板加判断，三处一起改，才算真的落地。

这里有个我吃亏吃出来的习惯：任何一次改动，先在测试库上跑一遍完整下单流程再上线，包括“下单 → 后台确认 → 打印 → 发货”整条链路，别只测自己改的那一个页面。老框架的耦合比想象中深，改订单表加字段，可能连带影响导出、统计、打印三个地方。从那以后我每次动数据库结构，都强制走一遍“备份 → 测试库执行 → 全链路点一遍 → 上线”，多花二十分钟，省掉的是半夜被叫起来回滚。希望帮到你。

本文还有配套的精品资源，点击获取