安装

本文面向正式部署 TanzCMS 的站长，说明从准备环境、上传程序到完成安装向导的完整步骤。

一、运行环境

建议环境：

项目	要求
PHP	PHP 8.4 或更高版本
数据库	MySQL 8.0 或 MariaDB 兼容版本
Web 服务	Nginx 或 Apache
PHP 扩展	pdo_mysql、mbstring、openssl、fileinfo、curl、gd、zip、xml、json
Composer	用于安装 PHP 依赖

二、上传程序

将 TanzCMS 程序上传到服务器上的目标站点项目目录。

站点运行目录必须设置为项目的 public 目录。

三、安装依赖

进入项目根目录，安装 Composer 依赖：

composer install --no-dev --optimize-autoloader

如果是已经打包好的完整安装包，且包内已经包含 vendor 目录，可以跳过这一步。

四、设置目录权限

确保以下目录可写：

storage
bootstrap/cache
public/uploads
public/assets

Linux 常见示例：

chmod -R 755 storage bootstrap/cache public/uploads public/assets
chown -R www:www storage bootstrap/cache public/uploads public/assets

www:www 需要按服务器实际运行用户调整。

五、创建数据库

在数据库管理工具中创建一个空数据库，并准备数据库账号：

数据库名：tanzcms
数据库用户：tanzcms_user
数据库密码：请使用高强度密码

数据库字符集建议使用：

utf8mb4

六、配置站点

确认服务器伪静态或重写规则已经把请求交给 public/index.php。

Nginx 参考规则：

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

Apache 需要启用 mod_rewrite，并允许读取 public/.htaccess。

七、运行安装向导

浏览器访问：

https://你的域名/install

安装向导会依次完成：

1. 检查 PHP 版本、扩展和目录权限。
2. 填写站点地址、数据库信息和后台入口。
3. 写入 .env 配置文件。
4. 创建数据库表并写入基础数据。
5. 创建第一个后台管理员账号。
6. 写入站点基础设置、SEO 设置和主题设置。
7. 生成安装锁文件。

八、安装完成

安装完成后会生成安装锁文件：

storage/app/installed.lock

存在安装锁后，访问 /install 只会显示已安装提示，不会再次进入安装表单。

九、上线检查

安装完成后建议检查：

• 首页可以正常访问。
• 后台入口可以登录。
• 上传图片、附件可以正常保存。
• 前台缩略图可以正常显示。
• 栏目页和内容页链接正常。
• .env 中 APP_DEBUG=false。
• .env 中 APP_URL 是正式访问域名。
• Web 根目录确实指向 public。

十、常用维护命令

清理缓存：

php artisan optimize:clear
php artisan tanzcms:template-clear

生产环境需要重新生成缓存时：

php artisan config:cache
php artisan view:cache