本教程适用于以下操作系统版本

  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)
  • Debian 9 (Stretch)

本页内容

  • 前提条件
  • 安装 LAMP Stack
  • 配置 MariaDB 部署
  • 为 TYPO3 CMS 创建新数据库和用户
  • 安装 Composer
  • 使用 Composer 下载 TYPO3 CMS
  • 设置 Apache 虚拟主机
  • 安装 TYPO3 CMS
  • 结论

TYPO3 是一个免费开源的企业级内容管理系统。它为企业级应用提供了许多特性,例如支持多站点的可扩展 CMS、多语言安装、强大的安全实现、极快的速度,并且可以在任何地方运行。

使用 TYPO3 CMS 可以让你构建灵活且可靠的网站。TYPO3 CMS 背后是一个活跃的专业社区。而且从设计上来说,TYPO3 CMS 是一个可插拔的内容管理系统,具有适应性强且解耦的架构。

在本指南中,我将向你展示如何在最新的 Debian 11 Bullseye 上使用 LAMP Stack 安装 TYPO3 CMS。此外,我们还将介绍 TYPO3 CMS 的典型基础安装。

前提条件

  • 一台 Debian 11 的 Linux 服务器。
  • 一个 root 用户或具有 root 权限的非 root 用户。
  • 一个指向服务器 IP 地址的域名。

安装 LAMP Stack

TYPO3 CMS 是用 PHP 编写的,因此你需要安装 LAMP 或 LEMP Stack 来进行安装。本指南将向你展示如何为 TYPO3 CMS 设置 LAMP Stack。

在安装一些软件包之前,运行下面的 apt 命令来更新你的仓库并刷新 Debian 系统上的软件包索引。

sudo apt update

接下来,使用以下命令安装基础的 LAMP Stack 软件包。

sudo apt install apache2 mariadb-server php php-common php-mysql libapache2-mod-php php-gd php-curl php-json php-xmlrpc php-intl php-bcmath php-zip php-apcu php-mbstring php-fileinfo php-xml php-soap

输入 Y 确认安装并按 ENTER 继续。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

所有软件包安装完成后,使用 nano 编辑器编辑配置文件 /etc/php/7.4/apache2/php.ini。

sudo nano /etc/php/7.4/apache2/php.ini

使用以下配置更改默认的 PHP 配置。

memory_limit = 512M
max_execution_time = 240
max_input_vars = 1500
date.timezone = Europe/Amsterdam
post_max_size = 50M
upload_max_filesize = 50

完成后保存文件。

最后,重启 Apache2 服务以应用对 PHP 配置的新更改,并验证 Apache2 服务。

sudo systemctl restart apache2
sudo systemctl status apache2

下面你将看到 Apache2 服务处于 active (running) 状态。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

配置 MariaDB 部署

你已经在服务器上安装了 MariaDB 服务器软件包,但仍处于默认设置。现在,我们将向你展示如何使用命令行工具 mysql_secure_installation 部署 MariaDB 服务器的安全性。

mysql_secure_installation 命令包含在 MariaDB 软件包中。它将帮助你为 MariaDB 服务器设置基本安全,例如设置 root 密码、移除默认的匿名访问、移除 test 数据库,以及禁用 MariaDB root 用户的远程登录。

执行下面的 mysql_secure_installation 命令以开始配置 MariaDB 部署。

sudo mysql_secure_installation

当询问当前的 root 密码时按 ENTER。

Enter current password for root (enter for none):
OK, successfully used password, moving on...

现在输入 Y 确认并将本地认证切换为 unix_socket。

Switch to unix_socket authentication [Y/n] Y
Enabled successfully!
Reloading privilege tables..
 ... Success!

现在输入 Y 确认为 MariaDB 服务器设置一个新的 root 密码。然后输入新密码并重复一次。请确保为 MariaDB root 用户设置一个强密码。

Change the root password? [Y/n] Y
New password:
Re-enter new password:
Password updated successfully!
Reloading privilege tables..
 ... Success!

现在输入 Y 以移除对 MariaDB 数据库服务器的默认匿名访问。

Remove anonymous users? [Y/n] Y
 ... Success!

输入 Y 以禁用 MariaDB root 用户的远程登录。要对 MariaDB 服务器进行远程连接,你需要创建另一个用户。

Disallow root login remotely? [Y/n] Y
 ... Success!

现在再次输入 Y 以从你的 MariaDB 服务器中移除默认的 test 数据库。

Remove test database and access to it? [Y/n] Y
 - Dropping test database...
 ... Success!
 - Removing privileges on test database...
 ... Success!

最后,再次输入 Y 以确认并重新加载 MariaDB 服务器上所有表的权限并应用新更改。

Reload privilege tables now? [Y/n] Y
 ... Success!

现在你已经完成了 MariaDB 数据库服务器的基本配置。

为确保所有更改都已应用到 MariaDB 服务器,运行下面的命令重启 MariaDB 服务并验证服务状态。

sudo systemctl restart mariadb
sudo systemctl status mariadb

现在你将看到 MariaDB 服务器处于 active (running) 状态。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

为 TYPO3 CMS 创建新数据库和用户

至此,你已经完成了 TYPO3 CMS 安装所需的基础 LAMP Stack 安装。现在你将为 TYPO3 CMS 创建一个新的 MariaDB 数据库和用户。

使用下面的 mysql 命令登录到 MariaDB shell。系统将要求你输入 MariaDB root 密码。

mysql -u root -p

现在运行以下 MariaDB 查询语句,创建一个新数据库 typo3db,用户为 typo3,密码为 typo3password。

CREATE DATABASE typo3db;
GRANT ALL PRIVILEGES ON typo3db.* to typo3@localhost IDENTIFIED BY 'typo3password';
FLUSH PRIVILEGES;
EXIT;

现在输入 EXIT 从 MariaDB shell 退出,并继续 TYPO3 CMS 的安装。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

安装 Composer

TYPO3 CMS 可以通过不同方式安装。在本指南中,你将使用 Composer 安装 TYPO3 CMS。所以现在你将在 Debian 11 服务器上安装 Composer。

首先,运行下面的命令下载 PHP Composer 安装程序并验证安装程序文件。

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '906a84df04cea2aa72f40b5f787e49f22d4c2f19492ac310e8cba5b96ac8b64115ac402c8cd292b8a03482574915d1a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

确保你看到输出消息 " Installer verified ",这表示安装程序文件是正确的。

接下来,运行 Composer 安装程序脚本以下载 Composer。下载完成后,删除该安装程序脚本。

php composer-setup.php
php -r "unlink('composer-setup.php');"

现在将文件 composer.phar 移动到 /usr/local/bin 目录,以便 Debian 系统上的用户能够运行 Composer。

sudo mv composer.phar /usr/local/bin/composer

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

最后,使用以下命令验证 Composer 的安装。

sudo -u www-data composer --version
sudo -u www-data composer -v

你将看到 PHP composer v2.3.3 已安装在你的 Debian 11 系统上,现在你已准备好安装 TYPO3 CMS。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

使用 Composer 下载 TYPO3 CMS

要开始 TYPO3 CMS 的安装,使用以下命令创建一个新目录 /var/www/typo3。

mkdir -p /var/www/typo3

将 /var/www/typo3 目录的所有权更改为用户 www-data,并允许 www-data 用户写入该目录。

sudo chown -R www-data:www-data /var/www/typo3
sudo chmod u+rw /var/www/typo3

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

接下来,进入 /var/www/typo3 目录并运行下面的 Composer 命令,将 TYPO3 CMS 安装到你的服务器上。

cd /var/www/typo3
sudo -u www-data composer create-project typo3/cms-base-distribution:^11 .

Composer 将下载 TYPO3 CMS 和 PHP 依赖。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

安装完成后,运行 ls 命令以验证 / var/www/typo3 下所有可用的文件和目录。

ls

你将看到名为 public 的目录,它是 TYPO3 CMS 默认的实际源码目录,并将用作虚拟主机配置的 DocuemtRoot。

设置 Apache 虚拟主机

使用 Composer 下载 TYPO3 CMS 之后,现在你将为 TYPO3 CMS 安装创建一个新的虚拟主机配置。

进入 /etc/apache2/sites-available 目录,并使用 nano 编辑器创建一个新的虚拟主机配置 typo3.conf。

cd /etc/apache2/sites-available/
sudo nano typo3.conf

将以下配置添加到新的虚拟主机 typo3.conf 中。确保更改域名和 SSL 证书的路径。

<VirtualHost *:80>
    ServerName example.io
    Redirect permanent / https://example.io/
</VirtualHost>
<VirtualHost *:443>
    ServerAdmin 
[email protected]
    DocumentRoot /var/www/typo3/public
    ServerName example.io
    Protocols h2 http/1.1
    SSLEngine On
    SSLCertificateFile /etc/letsencrypt/live/example.io/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/example.io/privkey.pem
     <Directory /var/www/typo3/public/>
          Options FollowSymlinks
          AllowOverride All
          Require all granted
     </Directory>
     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined
    
     <Directory /var/www/typo3/public/>
            RewriteEngine on
            RewriteBase /
            RewriteCond %{REQUEST_FILENAME} !-f
            RewriteRule ^(.*) index.php [PT,L]
    </Directory>
</VirtualHost>

完成后保存文件。

接下来,使用以下命令激活一些 Apache2 模块。

sudo a2enmod ssl rewrite headers

之后,激活虚拟主机配置 typo3.conf 并验证所有 Apache2 配置。

sudo a2ensite typo3.conf
sudo apachectl configtest

确保你看到消息 Syntax OK,这表示 Apache 配置是正确的。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

最后,运行以下命令重启并验证 Apache2 服务。并确保 Apache2 服务的状态为 active (running)。

sudo systemctl restart apache2
sudo systemctl status apache2

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

现在你已经完成了 TYPO3 CMS 安装的 Apache2 虚拟主机配置。

安装 TYPO3 CMS

在开始 TYPO3 CMS 安装之前,你需要在 public 目录内创建一个新的空白文件 FIRST_INSTALL。这将表明你是在这台服务器上首次安装 TYPO3 CMS。

使用以下命令在 public 目录下创建一个新文件 FIRST_INSTALL。

sudo -u www-data touch /var/www//typo3/public/FIRST_INSTALL

接下来,打开你的 Web 浏览器并输入 TYPO3 CMS 安装的域名。

https://example.io/

现在你将看到 TYPO3 CMS 安装的第一页。确保你的安装环境没有问题。然后点击绿色按钮继续。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

对于数据库配置,输入数据库用户名和密码,然后点击 Continue。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

现在选择选项 Use an existing empty database 并选择数据库 typo3db,然后点击 Continue。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

现在你需要为 YUPO3 CMS 创建一个管理员用户和密码,然后点击 Continue 完成安装。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

TYPO3 CMS 安装现已完成,点击按钮 Open the TYPO3 Backend。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

你将被重定向到 TYPO3 CMS 登录页面。输入你的管理员用户和密码,然后点击 Login。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

一旦用户名和密码正确,你将看到 TYPO3 CMS 管理仪表板。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

在 Admin 用户图标内,你将看到矩形菜单。点击它,你将看到 TYPO3 CMS 安装的详细环境。

在 Debian 11 上安装配置 TYPO3 CMS 内容管理系统完整教程

结论

恭喜!你现在已经在最新的 Debian 11 Bullseye 上使用 LAMP Stack 成功安装了 TYPO3 CMS。现在你可以为 TYPO3 CMS 创建自定义索引,并探索一些扩展来扩展 TYPO3 CMS 在你环境中的应用。