86 lines
4.3 KiB
Markdown
86 lines
4.3 KiB
Markdown
# 部署指南（深圳市云创芯电子有限公司 · 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/`）。
|
||
- 解压：
|
||
```bash
|
||
tar -xzf cloud-chip-laravel-vue.tar.gz -C /www/wwwroot/cloud-chip.cn/
|
||
```
|
||
|
||
## 2. 配置环境变量
|
||
```bash
|
||
cp .env.example .env
|
||
# 用编辑器打开 .env，至少修改以下项：
|
||
# APP_URL=https://你的域名
|
||
# DB_DATABASE / DB_USERNAME / DB_PASSWORD
|
||
# APP_DEBUG=false
|
||
# SESSION_SECURE_COOKIE=true # 启用了 HTTPS 才设 true
|
||
```
|
||
生成应用密钥：
|
||
```bash
|
||
php artisan key:generate
|
||
```
|
||
|
||
## 3. 数据库
|
||
```bash
|
||
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. 存储软链（文章图片上传需要）
|
||
```bash
|
||
php artisan storage:link
|
||
```
|
||
这会把 `storage/app/public` 映射到 `public/storage`，使上传的图片可通过网页访问。
|
||
|
||
## 5. 目录权限（Baota 面板或命令行）
|
||
确保以下目录**可写**（命令行示例）：
|
||
```bash
|
||
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 重写：
|
||
```nginx
|
||
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` 组件）：论坛帖子与回复署名、导航（桌面+移动端）、账户设置页均展示等级。
|
||
- **仍待办**：微信扫码注册（本期未排期，暂未实现）。
|