企业官网建设流程全解析

简介：这是一套基于PHP开发的爱家房产V9.39商业版门户网站源码，面向二手房、新房中介平台搭建者，以及需要二次开发房产系统的开发者。资源以超量静态页面部署，模板与程序分离，可无限深度定制；整合微信互动营销、UCenter论坛同步登录、付费置顶与刷新、地图标注、广告管理、手机触屏版、智能楼盘库、楼盘二维码、全站伪静态、后台操作日志、快速楼盘检索及域名绑定等功能，全面覆盖PC端、移动触屏端与小程序沙盘场景。压缩包共2001个文件，以htm/html静态页面为主，配合js交互脚本与css样式文件，另有md/json/xml说明配置、sql数据库结构以及少量py/sh辅助脚本，整体约65.5MB，目录模块清晰，包含完整数据库与静态页面，方便按模块检索定位。已有110人学习，适合熟悉PHP、希望快速搭建专业房产门户或进一步扩展二手房、新房门户及小程序生态的中高级开发者。

1. 爱家房产V9.39商业版拆解：为什么二手房新房门户要先盯这套源码

一开始拆爱家房产V9.39这套源码时，我的第一反应是“又一套CMS”，但看完目录结构和三端代码后改观了：它不是演示站，而是一套可以直接跑商业的完整系统。商业版版本号意味着它经历过多次迭代修补，公开的安装文档、伪静态规则、移动端适配都比较成熟。具体到包里，是PC门户网站、新手机端、楼盘沙盘功能加微信小程序四块，二手房、新房、经纪人、楼盘信息全部内置。

适合谁很清楚：不想从零编码、想快速在本地搭一个带真实房源发布功能门户的人，以及没有技术团队却想要三端数据统一的中介公司。后台发布房源后，PC、手机端、小程序都能同步看到，这是V9.39最实用的价值，也是我建议你从V9.39而不是老版本入手的原因。

这一套拆完，我最大的感受是：它的坑不在功能缺失，而在部署参数和环境匹配。下面从环境开始，一步步讲怎么把它跑起来。

2. 部署前先过环境关：PHP版本、伪静态与数据库初始化

2.1 运行环境选型：为什么V9.39兼容Apache也吃Nginx

先把环境选对，比安装本身更重要。爱家V9.39是PHP + MySQL架构，源码基于ThinkPHP 3.2的目录规范（Application、Runtime、Public），所以PHP版本不能太高——PHP 7.2以上会出现废弃函数警告，安装向导直接空白的情况我遇到过不止一次。常见做法是选PHP 5.6到7.1之间，同时打开短标签支持。

我一般把推荐环境列成这样一张表，照着配就行：

Nginx下配置伪静态是这一阶段最容易被卡住的点，因为Nginx默认不读取.htaccess。我一般用这段配置：

server { listen 80; server_name fang.xxx.com; root /www/wwwroot/fang; index index.php index.html; location / { if (!-e $request_filename) { rewrite ^/(.*)$ /index.php?s=$1 last; } } location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } }

这段是ThinkPHP 3.2的PATHINFO兼容写法。if (!-e $request_filename)表示文件不存在时才转发，避免静态资源被错误重写；s=$1是TP3常见的URL参数传法，房源详情、列表页都依赖这个规则。如果你的PHP-FPM用的是UNIX socket而不是9000端口，把fastcgi_pass改成sock文件的路径，否则会一直报502。

2.2 从压缩包到可访问站点：安装向导与目录权限

解压源码包后，先看到install目录和.htaccess文件。运行安装向导前，有三处权限必须处理：Runtime目录是ThinkPHP的编译缓存目录，权限不足时安装向导能走到第三步但写不了配置；Upload目录是房源图片上传目录；install目录本身也要可写。另外如果包内带了lock文件，不删掉的话安装向导会提示“已安装”。

cd /www/wwwroot/fang chmod -R 755 . chmod -R 777 Runtime chmod -R 777 Upload chmod -R 777 install find install -name "*.lock" -delete

然后浏览器访问http://您的域名/install，填写数据库地址、名称、账号密码和管理员账号。安装脚本会依次执行SQL导入、生成Application/Common/Conf/config.php并写安装锁。这里提醒两点：数据库端口不是默认3306时，地址栏要写成localhost:3307这种格式；安装完成后后台入口是/admin，第一次登录必须改后台管理员密码，默认密码写死在安装向导里，不改等于把门户后台敞给访问者。

2.3 后台第一件事：站点参数、导航菜单与房产分类

登录后台后别急着研究界面，按顺序做三件事就行：站点设置、导航菜单、房产分类。

站点设置在“系统配置 → 站点设置”，需要填站点名称、关键词、Logo、联系方式，这些直接输出到PC门户头部和SEO标题。然后是导航管理，把新房、二手房、租房、经纪人四个核心导航项打开。如果你要做本地门户，建议把导航顺序调整为“二手房→新房→租房→资讯”，二手房的搜索流量在绝大多数城市都高于新房。最后是房产分类，设置住宅、别墅、商铺、写字楼四种类型，价格单位用默认的元/月或元/平米。

有个隐式约定要特别留意：房源面积单位默认是平方米，不要改成其他单位，否则前端的区间搜索会失效。这个改完没有任何报错，但搜索结果永远为空，排查起来非常耗时间。我自己的习惯是在后台改任何下拉选项前，先去房产参数字典里看字段注释。

2.4 初始化测试数据：小区库与房源录入

后台配置完成后，需要至少发布一组测试数据来验证三端联动。爱家V9.39的小区库和房源是分开的，正确录入顺序是：先添加小区，再上传楼盘相册，最后发布房源时选择对应小区。小区库里的小区名称、地址、开发商、物业费、容积率、绿化率这些字段，会在房源详情页和沙盘展示时被调用。

手动一条条添加效率太低，常见做法是直接插一条SQL来快速验证核心流程：

INSERT INTO `aj_home_community` (`id`, `title`, `address`, `developer`, `property_fee`, `volume_rate`, `green_rate`, `status`) VALUES (1, '滨江花园', '杭州市滨江区江虹路1752号', '杭州滨江房产', 2.5, 2.8, 35.0, 1); INSERT INTO `aj_house` (`community_id`, `title`, `house_type`, `price`, `unit`, `area`, `bedroom`, `living_room`, `status`, `is_new`) VALUES (1, '滨江花园 3室2厅 精装修', 2, 450, 1, 118.5, 3, 2, 1, 0);

aj_是默认表前缀；status=1表示前台可见；is_new=0是二手房，is_new=1是新房。unit字段填1还是2，对应元/月或元/平米，不同模板对价格展示逻辑不同，别想当然改。插完后到前台二手房列表页刷新，能看到这条数据，就说明MySQL连接、模板解析、列表页SQL全部正常。接下来才进入界面和三端联动阶段。

3. 三端联动接线：PC门户、手机端、沙盘与角色配置

3.1 PC端红色宽屏界面与卡片式布局

“红色宽屏大气界面”在V9.39里不只是一个颜色值，而是一整套UI主题变量加布局模板的组合。前端资源在Public/ui目录，主题色通过CSS变量控制，换肤不需要改动模板文件本身：

/* Public/ui/css/style.css 顶部 */ :root { --primary: #c40000; /* 主色调：红色 */ --primary-dark: #a00000; --nav-height: 60px; --card-radius: 6px; }

改完变量后，还要搜索模板文件中的硬编码颜色。并不是所有模板都用了--primary变量，搜索#c40000、#b70000等关键词，找到后统一替换，否则会出现导航是红色、底部按钮还是暗红这种半吊子效果。宽屏布局方面，V9.39默认使用1200px容器，适合多数显示器；如果目标用户习惯1920宽屏，需要把容器宽度调成1400px并让banner区域通屏。注意“banner通屏”和“容器居中”是两套逻辑——外层CSS做绝对宽度，内层用max-width限制内容宽度。

3.2 手机端：自适应开关与卡片式界面

V9.39的新手机端不是简单响应式，而是配置了独立的触屏端模板。后台“手机版”配置里有个开关叫“手机版自动跳转”，开启后PC端检测到移动端UA会自动跳到/mobile目录。手机端界面的核心元素是卡片式界面：房源卡片、推荐小区卡片、经纪人卡片，布局由前端CSS控制。

卡片式布局的关键在于图片比例和标题截断：

.house-card .thumb { width: 100%; height: 0; padding-bottom: 75%; /* 4:3比例 */ background-size: cover; background-position: center; } .house-card .title { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }

4:3比例是为了适配封面图。如果后台上传的图片不是统一裁剪的，会出现背景图变形。我实际部署时会让上传接口强制做一次等比裁剪，缩略图路径一般带-thumb后缀，前端list.html调用的是裁剪后的图。如果直接用原图地址，移动端加载会明显变慢。

3.3 沙盘功能：楼盘底图与房源坐标标注

沙盘是这个版本比较特色的模块，把楼盘的楼栋分布、户型位置用可视化方式在前台呈现。这个模块在后台对应“沙盘管理”和“楼盘相册”两个菜单。配置的基本流程是三段式：

1. 在“楼盘管理”新建楼盘，填写楼栋数量、层高、容积率；
2. 在“沙盘管理”上传沙盘底图，通常是楼盘效果图或平面图；
3. 在底图上标注楼栋坐标与对应房源，保存坐标数据。

坐标数据存放在aj_community_map表里，保存的是相对坐标值。前台展示逻辑是：点击楼栋→弹出该楼栋的房源列表→点击房源进入详情。沙盘黑屏是这个模块最常见的故障，大部分原因是底图路径写死成绝对域名，迁移服务器后图片404，导致Canvas绘制时拿不到背景图。

3.4 用户角色与房源发布流程

前台“发布房源”功能默认只对注册用户开放，后台可以在“会员组管理”里调整。对中介公司来说，我建议配置两个角色：普通用户只能发求租求购，经纪人可以发布二手房和租赁房源。经纪人的发布路径是：我的中介后台→房源管理→添加房源→选择小区→填写户型、面积、价格、描述→上传图片→提交审核。

V9.39是否默认开启审核机制，取决于后台“审核开关”的状态。关掉审核的话，房源会立刻出现在前台列表，适合快速测试；正式运营我建议开启审核，避免垃圾房源污染列表页。

房源图片上传的默认限制是jpg、png、gif，单张不超过2MB。需要改的可以在Application/Common/Common/function.php中调整：

// 默认限制2MB，改为5MB，并补充webp格式 'upload_max_size' => 5 * 1024 * 1024, 'upload_ext' => 'jpg,jpeg,png,gif,webp',

改完记得清除Runtime缓存，否则不生效。这是ThinkPHP系最常见的不生效原因——编译缓存没清理。

4. 爱家房产V9.39避坑排查：安装、数据迁移、接口联调的翻车记录

这章是我拆包过程中踩过的比较深的几个点，全按“现象→原因→解决”整理，遇到一样的故障可以直接对号入座。

4.1 安装向导停在第一步，进度条转几圈后白屏

现象：访问/install时进度条走几步后页面空白，F12看Network发现index.php?c=install请求返回500或直接无响应。

原因：大多是PHP版本过高或short_open_tag关闭。V9.39源码里大量使用<?=短标签输出，PHP 7.4后短标签默认状态会因配置差异而关闭，模板解析中断。

解决：把PHP版本降到7.1或5.6，在php.ini确认short_open_tag = On后重启PHP-FPM。用宝塔面板的话，直接在“PHP设置”里打开短标签开关，比手动改配置更省事。

4.2 伪静态打开房源详情页404

现象：首页正常，但访问类似/house/12.html的详情URL时报404，或者返回ThinkPHP的“模块不存在”。

原因：Apache配置了rewrite但目录没有启用AllowOverride All；Nginx下则是没加重写规则，请求没进入index.php。还有一种是项目迁移时.htaccess文件丢失，Apache模式下URL无法解析。

解决：Nginx按2.1节配置重写规则；Apache确认虚拟主机配置包含AllowOverride All。一个快速验证方法是临时在URL后加?s=/house/12访问，能正常打开就说明是伪静态规则问题，跟程序无关。

4.3 系统迁移后图片全部裂开，路径带IP或旧域名

现象：从测试服务器迁到正式服务器后，所有房源缩略图加载失败，但数据库里的图片路径看起来是完整的。

原因：部分数据在入库时被写成了绝对路径http://旧IP/Upload/...，迁移后找不到旧地址。这个问题在爱家V9.39中常见于三个表：沙盘底图、楼盘相册、经纪人头像。

解决：用SQL直接替换前缀路径：

UPDATE `aj_community_map` SET `pic_url` = REPLACE(`pic_url`, 'http://旧域名/', ''); UPDATE `aj_house_pic` SET `pic_url` = REPLACE(`pic_url`, 'http://旧域名/', ''); UPDATE `aj_member` SET `avatar` = REPLACE(`avatar`, 'http://旧域名/', '');

如果新旧环境同时存在http和https，SQL要执行两遍，或者统一改成相对路径后在前台加固定前缀。改完记得刷新Runtime缓存。

4.4 小程序端登录报错，无法获取手机号

现象：小程序里点微信登录，后端返回“code无效”或“手机号获取失败”。

原因：小程序获取手机号按钮返回的code与登录code不是同一个，前端把它们混用了。另外后台APPID和AppSecret配置错误，或者小程序后台没添加测试成员，也会报同样的问题。

解决：确认后台小程序配置里APPID、AppSecret正确，并在小程序后台把“获取手机号”接口加入权限。测试阶段要在“成员管理”里添加体验成员，否则非开发者点击手机号按钮会直接提示“系统错误”。

4.5 沙盘黑屏或楼栋无法点击

现象：前台打开楼盘沙盘，页面框架正常但底图区域纯黑或灰色，点击楼栋无反应。

原因：底图加载失败。后台沙盘管理里填的是绝对路径，迁移后404；另一种是底图用了透明背景PNG，被前端脚本用Canvas绘制时，透明部分显示为黑色。

解决：底图上传后，在前台检查背景图地址能否直接访问。透明PNG就换个带底色的JPG，我习惯把沙盘底图统一处理成JPG、不超过1MB，既减少加载失败率也提升移动端速度。

5. 小程序端落地：登录获取手机号、接口核对与上线清单

5.1 联调前先把baseURL对齐

用微信开发者工具打开V9.39小程序端源码，第一步不是改界面，而是把接口域名和后端对齐。打开utils/config.js，确认baseURL是否指向你的正式服务器：

// utils/config.js module.exports = { baseURL: 'https://fang.xxx.com/index.php?s=/api', version: '1.0.0' };

替换后执行“清除缓存并重新编译”。然后打开Network面板，依次点击首页、房源列表、楼盘详情，观察请求是否返回200。小程序后台要把这个域名加入request合法域名，否则真机调试会直接报url not in domain list。调试阶段可以临时勾选“不校验合法域名”，上线前一定要关掉。

5.2 手机号登录的参数拆解

V9.39小程序端和老版本最大的差异在登录环节。用户点击手机号快捷登录按钮后，微信返回一次性动态code，小程序将code提交给后端；后端再通过APPID、AppSecret换取手机号，并建立登录态。

uni.login({ provider: 'weixin', success(loginRes) { uni.getPhoneNumber({ provider: 'weixin', success: (res) => { // res.code 与 loginRes.code 是不同的凭证，不要混用 uni.request({ url: `${baseURL}/login/phone`, method: 'POST', data: { code: res.code }, success: (r) => { if (r.data.code === 0) { uni.setStorageSync('token', r.data.token); } } }); } }); } });

容易翻车的地方有两处：一是把uni.login的code当手机号code用，两个接口需要的参数完全不同；二是动态code有效期只有5分钟，用户停在授权弹窗过久，再提交就会报“code无效”。

5.3 上线前必查清单与两个体验优化

上线前我每次都会强制走一遍下面这个清单：

• 合法域名已校验通过，开发者工具关闭“不校验合法域名”
• 手机号登录在iOS、Android各真机测一遍，确保都拿到手机号
• 房源详情页分享标题取的是房源名称，不是写死的“爱家房产”
• 沙盘页面在弱网下有加载提示，不会白屏卡死
• 后台关闭调试模式，接口报错信息不直接返回前端

两个体验优化值得优先做：顶部导航栏高度按胶囊按钮位置动态计算，避免不同机型出现双标题或标题重叠；房源详情页onLoad时用uni.setNavigationBarTitle设置页面标题为具体房源名称，而不是写死“房源详情”，用户分享出去时也能一眼认出内容。

有一个真实的教训：曾经有同事上线前把所有房源详情页的标题写死成“房源详情”，现场演示点开两套完全不同的房源，页面标题一模一样，当场翻车。从那以后我每次上线前都会把页面标题截图逐张比对，并按这份清单挨个打勾。希望帮到你。

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