部署指南（深圳市云创芯电子有限公司 · Laravel 12）

本包已包含 vendor/（Composer 依赖已安装），上传到服务器后无需再跑 composer install 即可运行。如需自行重装依赖，删除 vendor/ 后执行 composer install --no-dev --optimize-autoloader。

1. 上传与解压

将 cloud-chip-laravel-vue.tar.gz 上传到服务器网站根目录（如 Baota 的 /www/wwwroot/cloud-chip.cn/）。

解压：

tar -xzf cloud-chip-laravel-vue.tar.gz -C /www/wwwroot/cloud-chip.cn/

2. 配置环境变量

cp .env.example .env
# 用编辑器打开 .env，至少修改以下项：
#   APP_URL=https://你的域名
#   DB_DATABASE / DB_USERNAME / DB_PASSWORD
#   APP_DEBUG=false
#   SESSION_SECURE_COOKIE=true   # 启用了 HTTPS 才设 true

生成应用密钥：

php artisan key:generate

3. 数据库

php artisan migrate --force
# 如需初始演示数据（产品/文章/术语等）：
php artisan db:seed --force

本次发布包含新增迁移 2026_08_02_000001_add_profile_fields_to_users_table：在 users 表追加 real_name / phone / company / industry 四个资料字段（均允许为空）。 首次部署或升级时务必执行 migrate --force，否则详细注册收集到的字段无法落库。

4. 存储软链（文章图片上传需要）

php artisan storage:link

这会把 storage/app/public 映射到 public/storage，使上传的图片可通过网页访问。

5. 目录权限（Baota 面板或命令行）

确保以下目录可写（命令行示例）：

chmod -R 755 storage bootstrap/cache
# 若仍报权限错，再放宽到 775 / 777（仅限这两个目录）

文章配图、封面图通过 /upload 接口写入 storage/app/public/uploads/{年}/{月}/，该目录由上传时自动创建，且已随包带 storage/app/public/.gitkeep。上一步 chmod 755 storage 已覆盖此路径；若上传报「无法写入」，单独放宽： chmod -R 755 storage/app/public

6. Web 服务器（关键：docroot 必须是 public/）

Nginx：root 指向 .../public; 并加 Laravel 重写：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Apache：本包已带 public/.htaccess，只要把站点根目录设为 public/ 即可，无需额外配置。
⚠️ 不要用项目根的 router.php 跑生产（router.php 仅本地 php -S 调试用）。

7. 上线检查

访问首页、产品、文章、论坛、联系我们页均返回 200。
后台入口 /admin（需管理员账号，任意后台角色可登录）。
前台用户注册/登录在「论坛」页内；管理员登录在独立页面 /admin/login。

8. SEO 与搜索引擎收录（sitemap / robots）

上线后建议提交站点地图，加快收录：

robots 协议：访问 /robots.txt 自动返回（动态读取 APP_URL，无需手改域名），已对前台全开放，并屏蔽 /admin、/login、/register、/settings、/upload、/api 等后台与用户接口。
站点地图：访问 /sitemap.xml（机读 XML，含首页/关于我们/产品服务/文章/术语库/论坛/联系我们 + 全部已发布产品、文章、术语）。
提交地址：
- 百度搜索资源平台：https://ziyuan.baidu.com/ → 站点管理 → 链接提交 → 自动提交（sitemap）填入 https://你的域名/sitemap.xml
- Google Search Console：https://search.google.com/search-console → Sitemaps 填入 https://你的域名/sitemap.xml
上线检查项补一条：访问 /robots.txt 与 /sitemap.xml 均返回 200，且 Sitemap: 行域名与 APP_URL 一致。

备注

图标采用 x-icon（纯 SVG，无 emoji）；配色走 CSS 变量 token，未硬编码颜色。
本次已上线功能：
- 文章富文本编辑（Quill）+ 图片上传（/upload 接口）+ HTMLPurifier 净化，正文安全渲染 HTML。
- 详细注册：注册表单新增「真实姓名 / 手机号 / 公司名称 / 行业领域」四项（选填）。
- 会员等级徽章（level-badge 组件）：论坛帖子与回复署名、导航（桌面+移动端）、账户设置页均展示等级。
仍待办：微信扫码注册（本期未排期，暂未实现）。

4.3 KiB Raw Blame History Unescape Escape