简介这份资源是 discuz 点微同城 30.0 全套插件压缩包面向搭建本地生活服务平台的站长、开发者与运营团队覆盖同城分类信息、好店、招聘、房产、婚恋、拼团、抢购、抽奖、拼车、相亲、交友、电话本、签到、红包、子站点等常见同城业务场景并配套 H5 与小程序前端便于快速组装出一套功能完整的同城门户系统。压缩包为 zip 格式整体约 72.53MB内含 47 个插件模块按业务线拆分为独立插件目录方便按需启用与后期升级扩展。资源页面显示已有 679 人浏览学习说明该套件在同城系统搭建圈内有一定关注度。对于需要研究 discuz 插件结构、同城模块划分或小程序前端对接方式的读者可借此了解多插件协同的目录组织与功能边界作为二次开发或功能选型的参考样本。需注意资源不提供技术支持下载后需自行承担使用风险。1. 点微同城 30.0 拆包47 个插件到底怎么装、怎么跑起来如果你手里正好有一份discuz点微同城30.0全套插件(47个插件H5小程序前端.zip第一反应大概率是——这玩意儿到底能不能直接跑我拆过不少 Discuz 插件包这个体量的同城系统属于「功能全但结构散」的典型47 个插件不是 47 个独立 App而是围绕 Discuz 主程序挂载的一整套模块H5 前端和小程序前端各自独立打包后端逻辑全部走 Discuz 的插件钩子机制。它解决的核心问题是让你在一套 Discuz 论坛基础上快速搭出一个带分类信息、商家入驻、同城配送、多端访问的本地生活平台。适合谁适合手里已经有 Discuz 站点、想低成本扩同城业务的站长或者接私活需要快速交付同城类项目的开发者。不适合纯新手从零建站——你得先有一个能跑的 Discuz 环境否则后面全是坑。2. 环境准备与 Discuz 底座搭建别急着解压那 47 个插件2.1 为什么 Discuz 版本和 PHP 版本必须先锁死点微同城 30.0 是基于 Discuz X3.4/X3.5 体系开发的这个信息很关键。Discuz 从 X3.4 到 X3.5 虽然核心变化不大但插件钩子命名和模板解析机制有细微差异点微的插件包里大量使用了plugin.php入口和source/plugin/下的自定义模块如果 Discuz 版本不对最典型的表现是插件后台能装但前台不渲染或者直接白屏。PHP 版本我建议锁在 7.4不要上 8.x。Discuz X3.4 在 PHP 8 下有一堆弃用警告点微的部分插件代码写得比较早用了each()、create_function()这类在 PHP 8 里已经移除的函数你硬上 PHP 8 就是给自己找不痛快。MySQL 用 5.7 或 8.0 都行但字符集必须是utf8mb4因为同城系统里商家名称、商品描述很容易出现 emoji 和生僻字utf8会直接截断。常见做法是先用宝塔或 phpStudy 把 Discuz 跑起来确认论坛首页、后台、发帖都正常再动插件包。这一步别省我见过太多人 Discuz 本身都没装利索就开始解压插件最后排查半天发现是伪静态没配。2.2 Discuz 安装的实操步骤与参数假设你用宝塔面板新建站点后把 Discuz X3.4 的安装包上传到根目录解压后访问http://你的域名/install/。数据库配置这一步注意参数项建议值说明数据库字符集utf8mb4避免同城商家名乱码表前缀默认pre_或自定义点微插件默认按pre_写死改前缀要同步改插件配置管理员账号独立设置不要用 admin/admin 这种同城系统前台暴露面大伪静态开启 Rewrite同城分类页、商家页依赖伪静态规则安装完成后进后台「全局」→「站点功能」确认论坛、门户、家园这些模块该开的开。点微同城会用到门户和分类信息的部分能力如果门户没开部分插件的前台入口会 404。# 宝塔环境下建议的目录权限设置 chown -R www:www /www/wwwroot/你的站点目录 find /www/wwwroot/你的站点目录 -type d -exec chmod 755 {} \; find /www/wwwroot/你的站点目录 -type f -exec chmod 644 {} \; chmod -R 777 /www/wwwroot/你的站点目录/data chmod -R 777 /www/wwwroot/你的站点目录/uc_server/data chmod -R 777 /www/wwwroot/你的站点目录/config这几条命令的逻辑是属主给 Web 运行用户目录 755、文件 644 是安全基线data、uc_server/data、config这三个目录 Discuz 需要写入权限单独放开。别偷懒整个站点 777同城系统前台有商家上传入口权限太松等于开门揖盗。提示Discuz 安装完后先别急着装点微插件先注册一个普通用户测试发帖、上传图片、修改头像确认 UCenter 通信正常。UCenter 不通的话点微的会员同步会出玄学问题。3. 47 个插件的安装顺序与依赖关系乱装必翻车3.1 插件分类与安装优先级47 个插件不是平级的我拆包后大致分成四类第一类是核心框架插件比如点微的主程序插件、基础配置插件这些必须最先装它们会往 Discuz 的plugin表里注册钩子和菜单。第二类是功能模块插件比如商家入驻、分类信息、同城配送、拼团、砍价这些依赖核心框架。第三类是支付与通知插件微信支付、支付宝、短信通知这些要在功能模块之后配。第四类是辅助插件比如数据统计、SEO 优化、缓存清理最后装。安装顺序错了会怎样最典型的是功能模块插件装完后后台菜单里找不到入口因为核心框架插件还没注册对应的管理页面。或者支付插件先装了但功能模块还没装支付配置项里找不到要绑定的业务类型。# 解压插件包后的典型目录结构以实际包为准 # 假设解压到 /tmp/dianwei/ ls /tmp/dianwei/ # 可能看到 # source/plugin/ # 插件主目录 # template/ # 模板文件 # static/ # 静态资源 # install/ # 安装脚本 # h5/ # H5 前端工程 # miniprogram/ # 小程序前端工程安装时把source/plugin/下的每个插件目录整体复制到 Discuz 站点的source/plugin/下然后进 Discuz 后台「应用」→「插件」→「安装新插件」逐个安装。注意有些插件包会带自己的install.php需要先访问http://你的域名/source/plugin/插件名/install.php执行建表操作再回后台启用。3.2 数据库表前缀与插件配置的对应关系点微的插件在安装时会创建大量自定义表比如pre_dianwei_shop、pre_dianwei_order这类。如果你 Discuz 安装时改了表前缀比如改成bbs_那插件安装脚本里的 SQL 语句也得同步改。我一般会先在config/config_global.php里确认$_config[db][1][tablepre]的值然后批量替换插件安装脚本里的pre_。// 示例检查插件安装脚本中的表前缀 // 打开 source/plugin/dianwei_shop/install.php // 查找类似语句 // CREATE TABLE IF NOT EXISTS pre_dianwei_shop ( // 如果站点前缀是 bbs_改成 // CREATE TABLE IF NOT EXISTS bbs_dianwei_shop ( // 更稳妥的做法是用 Discuz 的 DB 类来建表 $sql CREATE TABLE IF NOT EXISTS .DB::table(dianwei_shop). ( id int(10) unsigned NOT NULL AUTO_INCREMENT, shop_name varchar(255) NOT NULL DEFAULT , PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;; DB::query($sql);用DB::table()的好处是 Discuz 会自动拼接你配置的表前缀不用手动替换。但点微的部分老插件是直接写死pre_的所以你得先 grep 一遍。# 批量检查插件目录里写死的表前缀 grep -r pre_dianwei /www/wwwroot/你的站点/source/plugin/ | head -50 # 如果站点前缀不是 pre_用 sed 批量替换先备份 cp -r /www/wwwroot/你的站点/source/plugin /tmp/plugin_backup grep -rl pre_dianwei /www/wwwroot/你的站点/source/plugin/ | xargs sed -i s/pre_dianwei/bbs_dianwei/g注意批量替换前一定备份而且替换完要检查有没有误伤比如某些字符串里恰好包含pre_dianwei但不是表名的情况。3.3 插件启用后的缓存清理与钩子刷新Discuz 的插件机制依赖缓存装完插件不更新缓存前台大概率不生效。后台「工具」→「更新缓存」要勾选「插件缓存」和「DIY 模块缓存」。另外有些插件会注册新的钩子到common或forum模板里如果模板缓存没清钩子代码不会执行。我一般装完一批插件后直接删data/cache/下的缓存文件再进后台更新缓存。顺序是先禁用所有插件 → 清缓存 → 逐个启用 → 再清缓存。这样能避免插件之间的钩子冲突导致白屏。4. H5 与小程序前端配置域名、接口、登录态三件套4.1 H5 前端的部署与接口地址配置H5 前端在插件包的h5/目录下通常是 Vue 或 uni-app 打包后的静态文件。部署方式很简单丢到站点的某个子目录或者独立域名下但接口地址必须指向 Discuz 的插件接口入口。// h5/config.js 或类似配置文件 // 常见配置项 window.__CONFIG__ { apiBase: https://你的域名/source/plugin/dianwei_api/, // 接口基础路径 wsUrl: wss://你的域名/wss, // 如果有 WebSocket appId: 你的微信AppID, // 公众号或小程序 AppID uploadUrl: https://你的域名/source/plugin/dianwei_api/upload.php };接口地址配错的表现是页面能打开但所有数据为空控制台一堆 404 或 500。先确认apiBase路径下确实有对应的 PHP 文件再确认 Discuz 的伪静态规则没有把source/plugin/下的请求重写到论坛路由。# Nginx 伪静态示例确保 source/plugin 下的请求不被 Discuz 主路由拦截 location /source/plugin/ { try_files $uri $uri/ /index.php?$query_string; } # 如果点微接口有自己的入口文件单独放行 location /source/plugin/dianwei_api/ { try_files $uri $uri/ 404; }4.2 小程序前端的编译与微信开发者工具配置小程序前端在miniprogram/目录下通常是原生小程序或 uni-app 编译产物。用微信开发者工具打开时注意几个参数配置项值说明AppID你自己的小程序 AppID不能用测试号点微的登录依赖正式 AppID服务器域名你的 Discuz 域名在微信公众平台「开发」→「开发设置」里配不校验合法域名开发时勾选上线前必须去掉编译模式自定义入口页面通常是pages/index/index小程序请求 Discuz 接口时最常见的翻车点是域名没配或者配了但没生效。微信要求所有请求域名必须 HTTPS且不能带端口443 除外。如果你 Discuz 站点是 HTTP小程序端直接请求会被拦截。// miniprogram/utils/request.js 典型封装 const BASE_URL https://你的域名/source/plugin/dianwei_api/; function request(url, data {}, method GET) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL url, data: data, method: method, header: { content-type: application/json, X-Discuz-Token: wx.getStorageSync(token) || // 登录态 }, success: (res) { if (res.data.code 0) { resolve(res.data.data); } else { reject(res.data); } }, fail: reject }); }); }登录态这块点微同城一般走微信授权登录小程序端wx.login()拿到 code 后传给后端后端换 openid 并生成 token。如果 token 存不住检查wx.setStorageSync是否被清以及后端返回的 token 字段名和前端读取的是否一致。4.3 微信登录与手机号获取的配置要点微信小程序登录获取手机号需要小程序有「获取手机号」权限且用户主动触发。点微的登录流程通常是wx.login→ 后端换 openid → 如果没绑手机号弹窗让用户点按钮获取手机号 → 后端解密手机号 → 绑定账号。// 获取手机号按钮的绑定事件 getPhoneNumber(e) { if (e.detail.errMsg getPhoneNumber:ok) { // 把加密数据传给后端解密 request(user/bindPhone, { encryptedData: e.detail.encryptedData, iv: e.detail.iv, sessionKey: this.data.sessionKey // 后端返回的 session_key }).then(res { // 绑定成功 }); } }后端解密手机号需要用到session_key这个值在小程序端wx.login后由后端调微信接口获取。如果解密失败常见原因是session_key过期或前端传的encryptedData不是最新的。我一般会在后端把session_key存 Redis 并设过期时间前端每次登录都重新拿。提示微信小程序认证费用是 300 元/年个人主体不能用获取手机号能力必须是企业主体。如果你只是测试可以用测试号但手机号获取会失败。5. 避坑与排查47 个插件跑起来后最容易遇到的 5 个问题5.1 插件后台能启用但前台入口 404现象Discuz 后台插件列表显示已启用但前台访问同城首页或商家列表页时 404。原因点微的插件前台入口通常是通过 Discuz 的plugin.php?id插件标识:控制器形式访问如果伪静态规则把plugin.php重写了或者插件标识和实际目录名不一致就会 404。解决先直接访问http://你的域名/plugin.php?iddianwei:index看是否正常如果正常说明是伪静态问题检查 Nginx/Apache 的 rewrite 规则里有没有放行plugin.php。如果直接访问也 404检查source/plugin/dianwei/目录下是否有对应的index.inc.php文件以及插件标识是否在后台「插件」列表里正确注册。5.2 小程序请求接口返回 500 但 H5 正常现象H5 端所有接口正常小程序端请求同一接口返回 500。原因小程序请求带的 header 和 H5 不同点微的部分接口会根据User-Agent或Referer做判断小程序的Referer是https://servicewechat.com/...如果后端有防盗链或来源校验会直接拒绝。解决检查接口入口文件里有没有checkReferer()之类的校验逻辑把servicewechat.com加入白名单。另外小程序请求默认不带 Cookie如果接口依赖 Discuz 的 Cookie 登录态需要改成 token 鉴权。5.3 商家上传图片失败但提示成功现象商家入驻时上传门头图前端提示上传成功但后台看不到图片。原因Discuz 的附件上传目录权限不对或者点微的插件把附件存到了自定义目录但该目录不存在。解决检查data/attachment/目录权限确认source/plugin/dianwei_api/upload.php里的保存路径是否存在。常见做法是插件会按日期建子目录比如data/attachment/dianwei/202501/如果dianwei目录没建上传就静默失败。# 手动创建上传目录并给权限 mkdir -p /www/wwwroot/你的站点/data/attachment/dianwei chown -R www:www /www/wwwroot/你的站点/data/attachment/dianwei chmod -R 755 /www/wwwroot/你的站点/data/attachment/dianwei5.4 支付回调不生效导致订单一直待支付现象用户微信支付成功但订单状态还是「待支付」商家收不到通知。原因微信支付的回调地址没配、配错或者回调地址被 Discuz 的伪静态拦截。解决在微信支付商户平台确认回调地址是https://你的域名/source/plugin/dianwei_api/pay/notify.php这类可公开访问的 URL且该 URL 不能被重定向。用curl模拟 POST 请求测试回调入口是否可达。# 测试回调入口是否可达返回非 404 即可 curl -I https://你的域名/source/plugin/dianwei_api/pay/notify.php # 如果返回 404检查文件是否存在、伪静态是否拦截5.5 多插件钩子冲突导致白屏现象装完第 20 多个插件后前台突然白屏Discuz 后台也进不去。原因多个插件注册了同一个钩子执行顺序冲突或者某个插件代码里有语法错误导致整个common加载失败。解决进数据库pre_plugin表把最近启用的插件available字段改成 0逐个排查。或者直接改config/config_global.php里的$_config[plugindeveloper]开启插件调试模式看具体报错。-- 紧急禁用所有插件 UPDATE pre_plugin SET available 0; -- 然后逐个启用定位冲突插件 UPDATE pre_plugin SET available 1 WHERE identifier dianwei;注意操作数据库前先备份别问我怎么知道的。6. 进阶把 47 个插件按业务线拆成可维护的模块47 个插件全装全开后台菜单能排三屏维护起来很痛苦。我的做法是按业务线拆成几个独立模块每个模块只启用相关插件用 Discuz 的插件权限控制不同用户组的访问。比如「同城信息」线只开分类信息、商家入驻、评论互动这几个插件「电商」线开商品、订单、支付、配送「营销」线开拼团、砍价、优惠券、抽奖。每条线单独配一个管理员账号后台菜单用 Discuz 的「管理权限」按用户组隔离。// 在插件的 admin 入口里做权限判断 // source/plugin/dianwei_shop/admin.inc.php if (!$_G[group][allowmanageshop]) { showmessage(您没有权限管理同城商家, , array(), array(alert error)); } // 然后在后台「用户」→「用户组」→「管理权限」里给对应用户组勾选 allowmanageshop验证模块是否隔离干净的方法用不同权限的账号登录后台确认只能看到自己业务线的菜单。前台也一样比如配送员账号只能看订单配送页看不到商家管理页。另一个进阶技巧是给插件包做版本管理。47 个插件不可能永远不更新我一般会在站点根目录外建一个dianwei_plugins_git目录把source/plugin/下的点微插件单独用 Git 管理每次更新前先 commit出问题直接回滚。Discuz 本身的插件目录不动只动点微相关的。# 在站点外管理插件版本 mkdir -p /www/dianwei_plugins_git cd /www/dianwei_plugins_git git init # 把 source/plugin 下点微相关目录软链或复制过来 cp -r /www/wwwroot/你的站点/source/plugin/dianwei* ./ git add . git commit -m 点微同城30.0初始版本 # 更新时先备份当前版本 git checkout -b backup_before_update # 替换新插件后再 commit从那以后我每次动插件目录前都强制走一遍 Git 提交哪怕只是改一个配置文件。同城系统跑起来后商家和用户的数据是无价的插件更新翻车能回滚比什么都重要。希望帮到你。本文还有配套的精品资源点击获取