Ubuntu 24.04にTYPO3 CMSをインストールする方法

TYPO3は、無料でオープンソースのエンタープライズグレードのコンテンツ管理システムです。マルチサイトサポート、マルチリンガルインストール、強力なセキュリティ実装、驚異的な速度を持ち、どこでも実行できるスケーラブルなCMSなど、エンタープライズレベルの機能を提供します。

TYPO3 CMSを使用すると、柔軟で信頼性の高いウェブサイトを構築できます。TYPO3 CMSは活気のあるプロフェッショナルコミュニティによって支えられています。設計上、TYPO3 CMSはプラグイン可能なコンテンツ管理システムであり、適応可能で分離されたアーキテクチャを持っています。

このガイドでは、Ubuntu 24.04サーバーにTYPO3をインストールします。LAMPスタック（Linux、Apache、MySQL/MariaDB、PHP）、Composer、およびGraphicsMagickを使用してTYPO3をインストールします。

前提条件

このガイドを始める前に、次のものを用意してください：

Ubuntu 24.04サーバー。
管理者権限を持つ非ルートユーザー。
サーバーIPアドレスにポイントされたドメイン名。

依存関係のインストール

TYPO3はPHPで書かれたオープンソースのコンテンツ管理システムであり、MySQL/MariaDBやPostgreSQLなどのデータベースをサポートしています。このセクションでは、LAMPスタック（Linux、Apache、MySQL/MariaDB、PHP）、PHP依存関係管理のためのComposer、および画像処理のためのGraphicsMagickを含むTYPO3の依存関係をインストールします。

始める前に、以下のコマンドでUbuntuパッケージインデックスを更新してください。

sudo apt update

update repo

次に、以下の「apt install」コマンドでTYPO3 CMSのパッケージ依存関係をインストールします。このコマンドを使用すると、LAMPスタック（Linux、Apache、MySQL/MariaDB、PHP）、PHPパッケージマネージャーとしてのComposer、Git、および自動画像処理のためのGraphicsMagickなどの依存関係をインストールします。

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

インストールを続行するにはYを入力してください。

インストールが完了したら、ApacheとMariaDBサービスのステータスを確認し、PHP、Composer、およびGraphicsMagickのバージョンを確認します。

以下のコマンドでApacheサービスのステータスを確認します。Apacheサービスの出力は「 enabled 」および「 active (running) 」であるべきです。

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

check apache

次に、以下のコマンドを使用してMariaDBサービスのステータスを確認します。出力はApacheと似ており、MariaDBサーバーは「 enabled 」および「 active (running) 」であることがわかります。

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadb

次に、以下のコマンドを実行してPHPとComposerのバージョンを確認します。Ubuntu 24.04では、デフォルトのPHPバージョンは8.3で、Composerは2.7.1です。

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

check php and composer

最後に、以下のコマンドを使用してGraphicsMagickのバージョンを確認します。UbuntuシステムにGraphicsMagick 1.3がインストールされていることがわかります。

gm version

check gm version

PHPの設定

TYPO3をインストールするには、デフォルトのPHP設定ファイル「php.ini」を変更する必要があります。ApacheとPHP CLIの両方の「php.ini」ファイルを編集し、TYPO3インストールのためのいくつかのデフォルト設定を変更する必要があります。

以下のnanoエディタコマンドを使用して、ApacheとPHP CLIの両方の「php.ini」ファイルを編集します。

sudo nano /etc/php/8.3/apache2/php.ini  
sudo nano /etc/php/8.3/cli/php.ini

以下の設定を変更します。「 memory_limit 」および「 date.timezone 」オプションをサーバー環境に合わせて調整してください。

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

ファイルを保存して終了します。

次に、以下のコマンドを実行してApacheサービスを再起動し、PHPの変更を適用します。

sudo systemctl restart apache2

その後、以下のコマンドを実行して「 /var/www/html 」ディレクトリに新しい‘info.php’ファイルを作成します。

echo "" > /var/www/html/info.php

最後に、お好みのウェブブラウザを使用してhttp://192.168.5.30/info.phpにアクセスします。PHP設定の詳細が表示され、「 php.ini 」を介して構成したすべてが適用されていることを確認します。

「Core」セクションを確認して、「 memory_limit 」、「 post_max_size 」、「 max_execution_time 」などのPHPインストールの設定を確認します。

phpinfo

MariaDBサーバーの設定

PHPを設定したので、MariaDBサーバーを保護し、TYPO3用の新しいデータベースとユーザーを作成する必要があります。このセクションでは、「 mariadb-secure-installation 」ユーティリティを使用してMariaDBを保護し、コマンドラインから新しいデータベースとユーザーを作成します。

以下の「 mariadb-secure-installation 」コマンドを実行して、MariaDBサーバーのインストールを保護します。

sudo mariadb-secure-installation

これで、MariaDBサーバーの設定を行うように求められます。デフォルト設定を受け入れるにはYを入力し、拒否するにはnを入力します。

デフォルトのMariaDBインストールにはパスワードがありません。パスワードを求められたらENTERを押します。
次に、MariaDBのrootパスワードを設定するためにYを入力します。次に、MariaDBの新しいパスワードを入力し、パスワードを繰り返します。
MariaDBインストールから匿名ユーザーを削除するためにYを入力します。
MariaDBのrootユーザーのリモートログインを無効にするように求められたら再度Yを入力します。
MariaDBからデフォルトデータベーステストを削除するためにYを入力します。
最後に、テーブル権限を再読み込みして新しい変更を適用するためにYを入力します。

MariaDBサーバーの設定が完了したら、以下のコマンドでMariaDBにログインします。プロンプトが表示されたらMariaDBのrootパスワードを入力します。

sudo mariadb -u root -p

次に、以下のクエリを実行して新しいデータベース「typo3db」と、新しいユーザー「typo3」を作成し、パスワード「Typo3Password」を設定します。必要に応じてデータベース情報を変更してください。

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

次に、以下のクエリを実行してユーザー「 typo3 」の権限を確認します。これにより、ユーザー「 typo3 」がTYPO3 CMSインストール用のデータベース「 typo3db 」にアクセスできることが確認されます。

SHOW GRANTS FOR typo3@localhost;

以下の出力は、ユーザー「 typo3 」がデータベース「 typo3db 」にアクセスできることを示しています。

最後に、MariaDBサーバーから退出するにはquitと入力します。

check user

Composerを使用してTYPO3をダウンロード

TYPO3のソースコードをインストールおよびダウンロードする方法はいくつかあります。まず、TYPO3インストールディレクトリを設定し、次にComposer（PHP依存関係管理）を使用してTYPO3をダウンロードします。

最初に、以下のコマンドを実行してComposerキャッシュと設定のための新しいディレクトリ、およびTYPO3インストールディレクトリ「 /var/www/typo3 」を作成します。

sudo mkdir -p /var/www/{.cache,.config,typo3}

次に、上記のディレクトリの所有権をユーザー「 www-data 」に変更し、「 /var/www/typo3 」ディレクトリへの読み取りおよび書き込みアクセスを有効にするために以下のコマンドを実行します。

sudo chown -R www-data:www-data /var/www/{.cache,.config,typo3}  
sudo chmod u+rw /var/www/typo3

次に、「 /var/www/typo3 」ディレクトリに移動し、以下の「 composer 」コマンドでTYPO3 CMSをインストールします。この例では、最新のTYPO3 CMS v12をUbuntuサーバーにインストールします。

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

以下にTYPO3 CMSのダウンロードおよびインストールプロセスを示します：

download composer

コマンドラインからTYPO3を設定

TYPO3 CMSのソースコードをダウンロードした後、コマンドラインを使用してTYPO3インストールを設定します。ウェブブラウザを使用してTYPO3インストールを設定することもできますが、ここではターミナルからTYPO3 CMSインストールを構成します。

コマンドを介してTYPO3 CMSインストールを設定するには、以下を実行します。

./vendor/bin/typo3 setup

以下の設定が求められます：

apacheをウェブサーバーとして入力します。
mysqliをデータベースドライバーとして入力します。
TYPO3 CMSに使用されるMariaDBユーザー、パスワード、ポート、およびホストの詳細を入力します。
データベース名としてtypo3dbを入力します。
TYPO3 CMSの管理者ユーザー、パスワード、およびメールアドレスを入力します。パスワードには少なくとも1つの特殊文字を含める必要があります。
プロジェクト名はデフォルトのままにします。
基本サイトを作成するように求められたらENTERを押します。

インストールが成功すると、「 おめでとうございます - TYPO3の設定が完了しました 」という出力が表示されます。

最後に、以下のコマンドを再実行して「 /var/www/typo3 」ディレクトリの所有権をユーザー「 www-data 」に変更します。

sudo chown -R www-data:www-data /var/www/typo3

configure typo3 via terminal

Apache仮想ホストの設定

ターミナルからTYPO3を設定したので、次にTYPO3インストールのためのApache仮想ホストを設定します。ドメイン名を準備していることを確認してください。

最初に、以下のコマンドでApacheの「 rewrite 」モジュールを有効にします。

sudo a2enmod rewrite

次に、以下のnanoエディタコマンドを使用して新しい仮想ホストファイル「 /etc/apache2/sites-available/typo3.conf 」を作成します。

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

以下の設定を挿入し、ServerNameオプションをTYPO3 CMSのドメイン名に変更してください。この例では、TYPO3 CMSはドメイン「 howtoforge.local 」で実行されます。

  
 ServerAdmin [email protected]  
 DocumentRoot /var/www/typo3/public  
 ServerName howtoforge.local  
  
   
 Options FollowSymlinks  
 AllowOverride All  
 Require all granted  
   
  
 ErrorLog ${APACHE_LOG_DIR}/error.log  
 CustomLog ${APACHE_LOG_DIR}/access.log combined  
   
   
 RewriteEngine on  
 RewriteBase /  
 RewriteCond %{REQUEST_FILENAME} !-f  
 RewriteRule ^(.*) index.php [PT,L]

次に、以下のコマンドを実行して「typo3.conf」仮想ホストファイルを有効にし、Apache構文を確認します。正しいApache構文がある場合、出力に「 Syntax OK 」が表示されます。

sudo a2ensite typo3.conf  
sudo apachectl configtest

最後に、以下のコマンドでApacheサービスを再起動してTYPO3 CMS仮想ホストを適用します。実行すると、TYPO3 CMSインストールが準備完了になります。

sudo systemctl restart apache2

setup apache

HTTPSでTYPO3 CMSを保護

このセクションでは、CertbotとLetsencryptを使用してTYPO3 CMSをHTTPSで保護します。CertbotはLetsencryptからSSL/TLS証明書を生成するために使用されます。また、Certbot Apacheプラグインを使用して仮想ホストで自動HTTPSを設定します。

以下のコマンドでCertbotとCertbot Apacheプラグインをインストールします。インストールを続行するにはYを入力してください。

sudo apt install certbot python3-certbot-apache

インストール後、以下の「certbot」コマンドを実行して、TYPO3 CMSのドメイン名用のSSL/TLS証明書を生成します。ドメイン名とメールアドレスを自分の情報に変更してください。

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

プロセスが完了すると、TYPO3 CMSは自動的にHTTPSで保護されます。SSL/TLS証明書は「 /etc/letsencrypt/live/domain.com 」ディレクトリにあります。

TYPO3へのアクセス

お好みのウェブブラウザを使用して、TYPO3 CMSのログインページにアクセスします。https://howtoforge.local/typo3にアクセスします。インストールが成功していれば、TYPO3 CMSのログインページが表示されるはずです。

管理ユーザーとパスワードを入力し、ログインをクリックして確認します。

ログインすると、次のようなTYPO3 CMS管理ダッシュボードが表示されます：

dashboard

右上のメニューで情報アイコンをクリックして、TYPO3 CMSスタックの詳細を取得します。以下のように、TYPO3 CMS 12.4がApache 2.4.58、MariaDBサーバー10.11、PHP 8.3でインストールされており、Composerモードが有効になっています。

system info

結論

おめでとうございます！Ubuntu 24.04サーバーにTYPO3 CMSをインストールしました。LAMPスタック（Linux、Apache、MySQL/MariaDB、PHP）、GraphicsMagick画像処理、およびComposerモードが有効な状態でTYPO3 CMSが稼働しています。また、CertbotとLetsencryptを使用してTYPO3 CMSをHTTPSで保護しました。