TYPO3是一款源自德国的开源企业级内容管理系统,基于PHP开发,以GPLv2协议开源。TYPO3诞生于1998年,是全球最成熟的企业级CMS之一,在欧洲市场占有率极高,被众多政府机构、大学、大型企业使用。TYPO3内置强大的多语言、多站点、工作流、权限管理、内容建模、模板引擎(Fluid)、扩展机制(Extensions),适合搭建企业官网、政府门户、高校网站、多语言站点、多站点群、大型内容平台。
核心优势:企业级稳定性和安全性、强大的多语言支持(50+语言)、多站点管理能力、灵活的内容建模、细粒度权限管理、工作流审批、丰富的扩展生态、专业的商业支持、长期版本支持(LTS)、SEO友好、可扩展性极强。TYPO3是中大型企业和机构组织的首选企业级CMS。
环境要求
- Web服务器:Nginx 1.20+ 或 Apache 2.4+
- PHP版本:PHP 8.1 ~ 8.3(TYPO3 12 LTS推荐PHP 8.2)
- 数据库:MySQL 8.0+ / MariaDB 10.4+ / PostgreSQL 12+
- 内存:最低1GB,推荐2GB以上(企业站点建议4GB+)
- 磁盘:至少1GB可用空间
- PHP扩展:pdo_mysql、gd、curl、mbstring、json、xml、zip、intl、opcache、apcu、fileinfo
- Composer:用于依赖管理(强烈推荐)
- ImageMagick或GraphicsMagick:用于图像处理(推荐)
安装教程
步骤1:安装Composer
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
php -r "unlink('composer-setup.php');"
composer --version
步骤2:使用Composer创建TYPO3项目
cd /www/wwwroot
composer create-project typo3/cms-base-distribution yourdomain.com ^12
cd yourdomain.com
这会创建标准的TYPO3项目结构,web目录为网站根目录。
步骤3:创建数据库
mysql -u root -p
CREATE DATABASE typo3 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'typo3_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON typo3.* TO 'typo3_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
步骤4:配置文件权限
chown -R www:www /www/wwwroot/yourdomain.com
chmod -R 755 /www/wwwroot/yourdomain.com
mkdir -p /www/wwwroot/yourdomain.com/web/typo3conf
chmod -R 775 /www/wwwroot/yourdomain.com/web/typo3conf
chmod -R 775 /www/wwwroot/yourdomain.com/web/fileadmin
chmod -R 775 /www/wwwroot/yourdomain.com/var
步骤5:创建FIRST_INSTALL文件
touch /www/wwwroot/yourdomain.com/web/FIRST_INSTALL
chown www:www /www/wwwroot/yourdomain.com/web/FIRST_INSTALL
步骤6:Nginx配置
server {
listen 80;
server_name yourdomain.com www.yourdomain.com;
root /www/wwwroot/yourdomain.com/web;
index index.php index.html;
client_max_body_size 50m;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location = /typo3 {
return 301 /typo3/;
}
location ~ \.php$ {
fastcgi_pass unix:/tmp/php-cgi-82.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_read_timeout 300;
fastcgi_buffer_size 128k;
fastcgi_buffers 256 16k;
}
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
location ~ /\.ht {
deny all;
}
location ~ /(typo3conf|typo3temp|fileadmin)/ {
# 允许访问,但限制执行PHP
location ~ \.php$ {
deny all;
}
}
}
步骤7:运行安装向导
浏览器访问 http://yourdomain.com/typo3,进入安装程序:
- 系统环境检查:确认PHP版本、扩展、目录权限等通过
- 数据库连接:填写数据库主机(localhost)、用户名(typo3_user)、密码、数据库名(typo3)
- 创建管理员账号:填写用户名、密码、邮箱
- 设置站点名称:输入网站名称
- 点击”安装”,等待安装完成
步骤8:登录后台
访问 http://yourdomain.com/typo3 登录后台。TYPO3后台称为TYPO3 Backend,功能模块包括:
- 页面(Page):页面树和内容编辑
- 列表(List):记录管理
- 信息(Info):页面信息
- 模板(Template):TypoScript模板配置
- 扩展(Extensions):扩展管理
- 用户(Users):用户和用户组管理
- 系统(System):系统配置、日志、数据库检查
基础配置
配置站点模板
在后台 → 模板(Template)模块中,选择根页面,创建一个新模板:
# 网站名称
config.sitename = 我的网站
# 语言设置
config.language = zh
config.locale_all = zh_CN.UTF-8
# 链接设置
config.absRefPrefix = /
config.baseURL = https://yourdomain.com/
# 缓存设置
config.cache_period = 86400
# 页面渲染
page = PAGE
page.typeNum = 0
page.10 = TEXT
page.10.value = Hello TYPO3!
安装扩展
在后台 → 扩展模块中浏览和安装扩展,或使用Composer:
composer require typo3/cms-seo
composer require bk2k/bootstrap-package
热门扩展推荐:
- bootstrap_package:Bootstrap模板包,快速建站
- news:新闻/博客扩展
- tt_address:地址/联系人扩展
- form:表单构建器
- seo:SEO增强
- realurl:URL重写(新版本已内置)
Windows环境安装(phpStudy集成环境)
对于Windows用户,推荐使用phpStudy或XAMPP集成环境快速搭建:
- 下载安装phpStudy(https://www.xp.cn)或XAMPP(https://www.apachefriends.org)
- 启动集成环境,开启Apache/Nginx和MySQL服务
- 将程序源码解压到网站根目录(phpStudy默认是WWW目录,XAMPP默认是htdocs目录)
- 打开phpMyAdmin创建数据库(访问http://localhost/phpmyadmin)
- 浏览器访问http://localhost,按照安装向导完成安装
注意:Windows环境仅推荐用于本地开发和测试,生产环境建议使用Linux服务器。
宝塔面板安装(推荐)
宝塔面板是国内最流行的服务器管理面板,支持一键部署PHP环境和网站:
- 安装宝塔面板:CentOS执行
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh,Ubuntu/Debian执行wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh - 安装完成后,登录宝塔面板(地址和账号密码在安装完成后显示)
- 首次登录提示安装LNMP/LAMP环境,选择Nginx + MySQL + PHP,点击一键安装
- 点击”网站” → “添加站点”,填写域名、选择PHP版本、创建数据库
- 将程序源码上传到网站根目录(/www/wwwroot/你的域名)
- 设置目录权限:在文件管理器中选中网站目录,权限设置为755,所有者为www
- 浏览器访问域名,按照安装向导完成安装
宝塔面板优势:可视化操作、一键环境配置、方便管理数据库和文件、内置SSL证书部署、适合新手和非技术用户。
服务器配置建议
- PHP内存限制:
memory_limit = 512M(企业站点建议1G) - 上传文件大小:
upload_max_filesize = 50M,post_max_size = 50M - 最大执行时间:
max_execution_time = 300 - 启用OPcache,设置
opcache.memory_consumption=256 - 安装APCu扩展用于用户缓存
- 配置Redis或Memcached缓存后端
- 安装ImageMagick用于图像处理
- MySQL配置优化:增加innodb_buffer_pool_size到1G
- 配置CDN加速静态资源
- 定期使用Composer更新TYPO3核心和扩展
- 定期备份数据库和fileadmin目录
- 生产环境关闭调试模式(Install Tool → Configuration Presets → Live)
常见问题
Q:安装时提示”缺少PHP扩展”?
A:根据提示安装对应扩展:apt install php8.2-gd php8.2-curl php8.2-mbstring php8.2-xml php8.2-zip php8.2-intl php8.2-apcu
Q:后台登录后显示空白或500错误?
A:检查PHP内存限制是否足够(至少256M),检查var目录是否可写,查看var/log目录下的错误日志。
Q:前台页面显示”Page Not Found”?
A:确认已创建站点模板(TypoScript模板),确认Nginx配置中包含try_files规则,确认根页面已设置为网站根。
Q:忘记管理员密码怎么办?
A:在项目根目录执行:php vendor/bin/typo3 backend:reset-password admin,按提示输入新密码。或使用Install Tool的密码重置功能。
Q:TYPO3和WordPress怎么选?
A:需要企业级功能、多站点、多语言、工作流、长期支持选TYPO3;需要简单易用、插件丰富、快速建站选WordPress。中大型企业和政府高校推荐TYPO3,中小企业和个人推荐WordPress。
Q:TYPO3可以免费商用吗?
A:可以。TYPO3基于GPLv2协议开源,完全免费商用。TYPO3协会提供付费的商业支持和认证服务,但软件本身免费。
官方网址
官方网站:https://typo3.org
下载地址:https://typo3.org/download
扩展市场:https://extensions.typo3.org