PHP / Laravel 接入

官方 Laravel 模板已内置完整接入层（template-laravel）：

app/Services/OcpsClient.php   # 签名 + 请求（完整可用）
app/Services/OcpsService.php  # 业务聚合（settings/content/category/commerce...）

快速起步

cd templates/template-laravel
cp .env.example .env
php artisan key:generate
php artisan serve --port=3360

.env 配置：

OCPS_API_BASE=http://127.0.0.1:3000      # 生产: https://api.ocps.cc
OCPS_APPID=app-xxxxxxxx
OCPS_AK=ak-xxxxxxxx
OCPS_SK=sk-xxxxxxxxxxxxxxxx
ADMIN_PATH=adm-xxxxxxxx                  # 随机后台路径

使用示例

$svc = app(\App\Services\OcpsService::class);

// 站点设置
$settings = $svc->settings();

// 已发布内容列表（分页）
$posts = $svc->posts(['page' => 1, 'page_size' => 20]);

// 分类树
$cats = $svc->categories('', 500);

// 产品（active）
$products = $svc->products(['page_size' => 12]);

路由约定（SEO 友好）

Laravel 模板内置多语言路由：

Route::get('/{lang}', [SiteController::class, 'home'])->where('lang', 'en|cn|tw|jp|de|fr|es|ar');
Route::get('/{lang}/{module}/list/{slug}', [SiteController::class, 'category']);
Route::get('/{lang}/{module}/list/d/{slug}', [SiteController::class, 'detail']);

这样每个 URL 都带语言前缀与语义 slug，爬虫可读，配合 hreflang / canonical 输出多语言 SEO。

管理后台

应用自带独立后台（随机路径），包含：仪表盘、内容管理、产品管理、分类管理、可视化编辑器、模板中心、访客统计、站点设置。一切数据仍存 OCPS 子平台，应用无数据库。