where('enabled', 1) ->order('sort asc, id desc') ->select(); $list = []; foreach ($rows as $row) { $image = (string)$row['image']; if ($image !== '' && !preg_match('/^https?:\/\//i', $image)) { $image = cdnurl($image, true); } $list[] = [ 'id' => (int)$row['id'], 'title' => (string)$row['title'], 'image' => $image, 'link' => (string)$row['link'], 'color' => (string)$row['color'], ]; } $this->ok($list); } /** * H2 分类导航 * GET /api/v1/home/categories → [{id,name,iconKey,icon,color,count}] * 规则:仅 enabled=1,按 sort asc;icon 为固定 /static/icons/ 文件名(按 id 映射) */ public function categories() { $rows = Db::name('fc_category') ->where('enabled', 1) ->order('sort asc') ->select(); $list = []; foreach ($rows as $row) { $id = (int)$row['id']; $iconKey = (string)$row['icon_key']; $list[] = [ 'id' => $id, 'name' => (string)$row['name'], 'iconKey' => $iconKey, 'icon' => $this->resolveCategoryIconPath($id, $iconKey), 'color' => (string)$row['color'], 'count' => (int)$row['post_count'], ]; } $this->ok($list); } /** * H3 热门搜索 * GET /api/v1/home/search/hot → [string] * 规则:读配置 home.hotKeywords,未配置则返回默认 */ public function hotKeywords() { $default = ['租房 一室一厅', '二手电动车', '急招快递员', '钢琴家教', '空调维修']; $keywords = $this->cfg('home.hotKeywords', $default); if (!is_array($keywords) || !$keywords) { $keywords = $default; } $this->ok(array_values($keywords)); } /** * H5 服务区域列表(平铺:每条记录自带省 / 市 / 区县) * GET /api/v1/home/areas → [{id,province,city,district,lat,lng}] * 规则:仅 enabled=1;按省、市、sort、id 排序。 * 区县为最终服务区域;省 / 市由前端按 distinct 值生成级联列。 */ public function areas() { $rows = Db::name('fc_area') ->where('enabled', 1) ->order('province asc, city asc, sort asc, id asc') ->select(); $list = []; foreach ($rows as $row) { $list[] = [ 'id' => (int)$row['id'], 'province' => (string)$row['province'], 'city' => (string)$row['city'], 'district' => (string)$row['district'], 'lat' => $row['lat'] !== null ? (float)$row['lat'] : null, 'lng' => $row['lng'] !== null ? (float)$row['lng'] : null, ]; } $this->ok($list); } /** * H6 按定位坐标匹配服务区域(区县) * GET /api/v1/home/locate?lat=&lng= → {areaId,province,city,district,distance} * 规则:在启用的服务区域中心点中取最近的一个(Haversine),超出 300km 视为不在服务范围,返回 null。 */ public function locate() { $lat = $this->input('lat', null); $lng = $this->input('lng', null); if (!is_numeric($lat) || !is_numeric($lng)) { $this->ok(null); } $lat = (float)$lat; $lng = (float)$lng; if ($lat < -90 || $lat > 90 || $lng < -180 || $lng > 180 || ($lat == 0.0 && $lng == 0.0)) { $this->ok(null); } $rows = Db::name('fc_area') ->where('enabled', 1) ->whereNotNull('lat') ->whereNotNull('lng') ->select(); $best = null; foreach ($rows as $row) { $distance = $this->haversine($lat, $lng, (float)$row['lat'], (float)$row['lng']); if ($best === null || $distance < $best['distance']) { $best = ['row' => $row, 'distance' => $distance]; } } if (!$best || $best['distance'] > 300) { $this->ok(null); } $area = $best['row']; $this->ok([ 'areaId' => (int)$area['id'], 'province' => (string)$area['province'], 'city' => (string)$area['city'], 'district' => (string)$area['district'], 'distance' => $best['distance'], ]); } /** * H4 信息流 * GET /api/v1/home/feed {categoryId?,keyword?,areaId?,area?,sort?,lat?,lng?,page,size} * → {list,page,size,total,hasMore} * 规则:仅 audit_status=1 AND status=1 AND deletetime IS NULL * - sort=nearby 时按距离升序(无坐标的信息排最后;请求未带 lat/lng 则回落发布时间倒序); * - 列表项 distance 为 km(一位小数),请求未带坐标 / 信息未定位时为 null。 */ public function feed() { list($page, $size) = $this->pager(); $categoryId = (int)$this->input('categoryId', 0); $keyword = trim((string)$this->input('keyword', '')); $area = trim((string)$this->input('area', '')); // 服务区域 ID(兼容上一版的 districtId 参数) $areaId = (int)$this->input('areaId', 0); if (!$areaId) { $areaId = (int)$this->input('districtId', 0); } $sort = (string)$this->input('sort', ''); // 容错处理:过滤前端小程序可能序列化出的 undefined 与 null 字符串 if ($area === 'undefined' || $area === 'null') { $area = ''; } if ($keyword === 'undefined' || $keyword === 'null') { $keyword = ''; } if ($sort === 'undefined' || $sort === 'null') { $sort = ''; } $query = Db::name('fc_post') ->where('audit_status', 1) ->where('status', 1) ->whereNull('deletetime'); if ($categoryId > 0) { $query->where('category_id', $categoryId); } if ($keyword !== '') { $query->where('title', 'like', '%' . $keyword . '%'); } $applyArea = function ($q) use ($area, $areaId) { // 服务区域 = 区县:areaId 优先,兼容旧的 area=区县名称 if ($areaId > 0) { $row = Db::name('fc_area')->where('id', $areaId)->find(); if ($row) { $q->where(function ($w) use ($row) { $w->where('district_id', (int)$row['id'])->whereOr('area', (string)$row['district']); }); } return; } if ($area !== '') { $q->where('area', $area); } }; $applyArea($query); // 付费发帖拦截:未付清款项的帖子(微信支付待付款)严禁向外展示 $applyPaid = function ($q) { $q->where(function ($w) { $w->where('amount', 'null')->whereOr('amount', '<=', 0)->whereOr('is_paid', 1); }); }; $applyPaid($query); $counter = Db::name('fc_post') ->where('audit_status', 1) ->where('status', 1) ->whereNull('deletetime'); if ($categoryId > 0) { $counter->where('category_id', $categoryId); } if ($keyword !== '') { $counter->where('title', 'like', '%' . $keyword . '%'); } $applyArea($counter); $applyPaid($counter); $total = $counter->count(); // 「附近」:距离在 PHP 内用 Haversine 计算后排序(不用 SQL 距离函数,避免 MySQL 兼容问题); // 因排序依赖计算结果,这里取全量匹配行排序后再做**内存分页**,保证 page/size/total 一致。 if ($sort === 'nearby') { $rows = $query->order('createtime desc')->select(); $items = []; foreach ($rows as $row) { $items[] = [ 'item' => $this->buildPost($row), 'distance' => $this->postDistance($row), 'ct' => (int)$row['createtime'], ]; } usort($items, function ($a, $b) { $na = $a['distance'] === null; $nb = $b['distance'] === null; if ($na !== $nb) { return $na ? 1 : -1; // 无坐标的排最后 } if (!$na && $a['distance'] != $b['distance']) { return $a['distance'] < $b['distance'] ? -1 : 1; } return $b['ct'] - $a['ct']; // 距离相同(或都无坐标):新的在前 }); $list = []; foreach ($items as $it) { $list[] = $it['item']; } $this->ok($this->paginateArray($list, $page, $size)); } if ($sort === 'price') { $query->order('is_top desc, price asc'); } elseif ($sort === 'hot') { $query->order('is_top desc, views desc'); } else { // 后台「置顶」优先展示,其余按发布时间倒序 $query->order('is_top desc, createtime desc'); } $rows = $query->page($page, $size)->select(); $list = []; foreach ($rows as $row) { $list[] = $this->buildPost($row); } $this->ok($this->paginate($list, $total, $page, $size)); } /** * Haversine 距离(km,一位小数)—— 与 Post 控制器同一算法 * @return float */ protected function haversine($lat1, $lng1, $lat2, $lng2) { $earth = 6371.0; $rad = M_PI / 180; $dLat = ($lat2 - $lat1) * $rad; $dLng = ($lng2 - $lng1) * $rad; $a = sin($dLat / 2) * sin($dLat / 2) + cos($lat1 * $rad) * cos($lat2 * $rad) * sin($dLng / 2) * sin($dLng / 2); $c = 2 * asin(min(1.0, sqrt($a))); return round($earth * $c, 1); } /** * 列表项距离(km,一位小数;请求未带坐标 / 信息未定位 = null) * @param array $row fc_post 行 * @return float|null */ protected function postDistance($row) { $lat = $this->input('lat', null); $lng = $this->input('lng', null); if (!is_numeric($lat) || !is_numeric($lng)) { return null; } $lat = (float)$lat; $lng = (float)$lng; if ($lat == 0.0 && $lng == 0.0) { return null; } $plat = isset($row['lat']) && $row['lat'] !== null ? (float)$row['lat'] : 0.0; $plng = isset($row['lng']) && $row['lng'] !== null ? (float)$row['lng'] : 0.0; if ($plat == 0.0 && $plng == 0.0) { return null; } return $this->haversine($lat, $lng, $plat, $plng); } /** * 组装 Post 结构(与前端 mock 数据字段严格对齐) * @param array $row fc_post 行 * @return array */ protected function buildPost($row) { $categoryName = ''; if (!empty($row['category_id'])) { $cat = Db::name('fc_category')->where('id', $row['category_id'])->find(); if ($cat) { $categoryName = (string)$cat['name']; } } $publisher = ['id' => 0, 'name' => '', 'avatar' => '', 'isMerchant' => false, 'verified' => false]; if (!empty($row['user_id'])) { $pub = Db::name('user')->where('id', $row['user_id'])->find(); if ($pub) { $pubExt = Db::name('fc_user_ext')->where('user_id', $pub['id'])->find(); $isMerchant = $pubExt && (int)$pubExt['user_type'] === 2; $publisher = [ 'id' => (int)$pub['id'], 'name' => (string)$pub['nickname'], 'avatar' => (string)$pub['avatar'], 'isMerchant' => (bool)$isMerchant, 'verified' => (bool)$isMerchant, ]; } } $tags = []; if (!empty($row['tags'])) { foreach (explode(',', (string)$row['tags']) as $tag) { $tag = trim($tag); if ($tag !== '') { $tags[] = $tag; } } } return [ 'id' => (int)$row['id'], 'categoryId' => (int)$row['category_id'], 'categoryName' => $categoryName, 'title' => (string)$row['title'], 'content' => (string)$row['content'], 'cover' => (string)$row['cover'], 'price' => (float)$row['price'], 'priceUnit' => (string)$row['price_unit'], 'area' => (string)$row['area'], 'areaId' => (int)$row['district_id'], 'address' => (string)$row['address'], 'contact' => $this->maskPhone($row['phone']), 'views' => (int)$row['views'], 'likes' => (int)$row['likes'], 'isPaid' => (int)$row['is_paid'] === 1, 'isTop' => (int)$row['is_top'] === 1, 'auditStatus' => (int)$row['audit_status'], 'createdAt' => $this->iso($row['createtime']), 'tags' => $tags, 'publisher' => $publisher, 'commentCount' => (int)$row['comment_count'], 'distance' => $this->postDistance($row), ]; } /** * 全兼容分类图标路径解析 * 规则:网络URL或相对路径直接透传;支持根据 iconKey 或 分类 ID 智能映射内置图标;默认回落 cat-job.png 兜底 * @param int $id 分类ID * @param string $iconKey 分类图标键名或图片路径 * @return string */ protected function resolveCategoryIconPath($id, $iconKey = '') { if ($iconKey !== '') { if (preg_match('/^https?:\/\/|^\/uploads\/|^\/static\//i', $iconKey)) { return $iconKey; } $iconFileName = (strpos($iconKey, '.') !== false) ? $iconKey : $iconKey . '.png'; if (file_exists(ROOT_PATH . 'public/static/icons/' . $iconFileName)) { return '/static/icons/' . $iconFileName; } $keyMap = [ 'cat-job' => 'cat-job.png', 'cat-house' => 'cat-house.png', 'cat-goods' => 'cat-goods.png', 'cat-car' => 'cat-car.png', 'cat-service' => 'cat-service.png', 'cat-education' => 'cat-education.png', 'cat-clean' => 'cat-clean.png', 'cat-friend' => 'cat-friend.png', ]; if (isset($keyMap[$iconKey])) { return '/static/icons/' . $keyMap[$iconKey]; } } return '/static/icons/' . $this->iconFile($id); } /** * 分类 id → 固定图标文件名(向下兼容) * @param int $id * @return string */ protected function iconFile($id) { $map = [ 1 => 'cat-job.png', 2 => 'cat-house.png', 3 => 'cat-goods.png', 4 => 'cat-car.png', 5 => 'cat-service.png', 6 => 'cat-education.png', 7 => 'cat-clean.png', 8 => 'cat-friend.png', ]; return isset($map[$id]) ? $map[$id] : 'cat-job.png'; } }