theday-seeyou / web-base-temple
Bilingual enterprise CMS and website starter built on ThinkPHP
Package info
github.com/theday-seeyou/web-base-temple
Type:project
pkg:composer/theday-seeyou/web-base-temple
Requires
- php: >=8.1
- ext-json: *
- theday-seeyou/web-base-core: ^0.3
- topthink/framework: ^8.0
- topthink/think-migration: ^3.0
- topthink/think-orm: ^3.0
- topthink/think-view: ^2.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
WebBase CMS 是面向企业官网的中英文内容管理系统,基于 ThinkPHP 8 和自有 Composer 核心包 theday-seeyou/web-base-core 构建。
环境要求
- PHP 8.1 或更高版本。
- MySQL 5.7 / 8.0 或兼容的 MariaDB。
- Composer 2。
- PHP 扩展:
curl、gd、iconv、json、mbstring、openssl、pdo_mysql、zlib。
创建新项目
推荐直接使用 Composer 创建独立站点:
composer create-project theday-seeyou/web-base-temple my-company-site "^0.3" cd my-company-site
创建本地环境配置。
Windows PowerShell:
Copy-Item .env.example .env
macOS / Linux:
cp .env.example .env
编辑 .env,至少填写数据库连接:
DB_MYSQL_HOST=127.0.0.1 DB_MYSQL_PORT=3306 DB_MYSQL_USERNAME=root DB_MYSQL_DATABASE=webbase_cms DB_MYSQL_PASSWORD=your-password
创建一个使用 utf8mb4 的空数据库:
CREATE DATABASE `webbase_cms` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
执行初始化迁移:
php think migrate:run
启动开发服务器:
php think run -H 127.0.0.1 -p 8000
访问:
- 网站:
http://127.0.0.1:8000/ - 后台:
http://127.0.0.1:8000/admin - 初始账号:
admin - 初始密码:
admin
首次登录后应立即修改初始密码。若 8000 端口已被占用,可将 -p 8000 改为其他端口。
从 GitHub 开发
需要参与 CMS 开发时,也可以直接克隆:
git clone https://github.com/theday-seeyou/web-base-temple.git
cd web-base-temple
composer install
然后按照上面的步骤创建 .env、数据库并执行迁移。
核心包位于独立仓库:
- GitHub:https://github.com/theday-seeyou/web-base-core
- Packagist:https://packagist.org/packages/theday-seeyou/web-base-core
CMS 始终通过正式版本依赖核心包,不使用本地 path 仓库,也不会在 Composer 安装阶段覆盖项目源码。
常用命令
php think migrate:status php think migrate:run php think route:list php think clear composer audit
WebBase Core 提供以下显式命令:
php think webbase:publish php think webbase:database php think webbase:queue php think webbase:sysmenu
webbase:publish 默认不会覆盖已有文件。只有开发者显式传入 --force 时才允许覆盖。
生产部署
composer install --no-dev --classmap-authoritative php think migrate:run --no-interaction
Web 服务器的站点根目录必须指向 public/。不要把 .env、源码根目录或数据库凭据暴露到公网。
项目范围
- 后台登录、权限、菜单、系统配置、文件与日志管理。
- 内容栏目基础模型。
- ThinkPHP 多语言能力。
- 后续建设页面、文章、导航、表单、SEO、模板安装与中英文内容工作流。
架构与发布流程:
开源协议
项目自身代码使用 MIT License。由第三方开源项目改造的部分遵循其原始许可证,详见 THIRD_PARTY_NOTICES.md。