Debian 11にTYPO3 CMSをインストールする方法

このチュートリアルはこれらのOSバージョンのために存在します

Debian 12 (ブックワーム)
Debian 11 (Bullseye)
Debian 9（ストレッチ）

このページで

前提条件
LAMPスタックのインストール
MariaDBのデプロイメントの構成
TYPO3 CMSのための新しいデータベースとユーザーの作成
Composerをインストールする
Composerを使用してTYPO3 CMSをダウンロードする
Apacheの仮想ホストの設定
TYPO3 CMSのインストール
結論

TYPO3は、無料でオープンソースのエンタープライズグレードのコンテンツ管理システムです。マルチサイトサポートを備えたスケーラブルなCMS、マルチリンガルのインストール、強力なセキュリティ実装、驚くほどの速さ、どこでも実行できるなど、エンタープライズレベルの利用に多くの機能を提供しています。

TYPO3 CMSを使用すると、柔軟で信頼性の高いウェブサイトを構築できます。TYPO3 CMSは、活気に満ちた専門家コミュニティをバックエンドに持っています。また、TYPO3 CMSはプラグイン対応のコンテンツ管理システムであり、適応可能で分離されたアーキテクチャを持っています。

このガイドでは、最新のDebian 11 BullseyeにLAMPスタックを使用してTYPO3 CMSをインストールする方法を説明します。また、TYPO3 CMSの典型的な基本インストールについても説明します。

前提条件

Debian 11のLinuxサーバー。
ルートユーザーまたはルート特権を持つ非ルートユーザー。
ドメイン名はサーバーのIPアドレスにポイントされています。

LAMPスタックのインストール

TYPO3 CMSはPHPで書かれているため、インストールにはLAMPまたはLEMPスタックをインストールする必要があります。このガイドでは、TYPO3 CMSのためのLAMPスタックの設定方法を示します。

いくつかのパッケージをインストールする前に、以下の apt コマンドを実行して、リポジトリを更新し、Debian システムのパッケージインデックスをリフレッシュしてください。

sudo apt update

次に、以下のコマンドを使用して基本的なLAMPスタックパッケージをインストールします。

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を押してください。

すべてのパッケージのインストールが完了したら、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サービスがアクティブ（実行中）であることが表示されます。

MariaDBのデプロイメントの構成

あなたはサーバーにMariaDBサーバーパッケージをインストールしましたが、まだデフォルト設定のままです。これから、コマンドラインツールmysql_secure_installationを使用してMariaDBサーバーのセキュリティを展開する方法をお見せします。

mysql_secure_installationコマンドはMariaDBパッケージに含まれています。このコマンドは、MariaDBサーバーの基本的なセキュリティを設定するのに役立ちます。例えば、rootパスワードの設定、デフォルトの匿名アクセスの削除、テストデータベースの削除、MariaDBのrootユーザーのリモートログインの無効化などです。

mysql_secure_installationコマンドを以下に実行して、MariaDBのデプロイメントの設定を開始します。

sudo mysql_secure_installation

現在のルートパスワードが求められたら、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サーバーの新しいルートパスワードを設定してください。その後、新しいパスワードを入力し、再度入力してください。MariaDBのルートユーザーには強力なパスワードを設定してください。

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

今、MariaDBデータベースサーバーへのデフォルトの匿名アクセスを削除するにはYを入力してください。

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

YをタイプしてMariaDBのルートユーザーのリモートログインを無効にしてください。MariaDBサーバーへのリモート接続には、別のユーザーを作成する必要があります。

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

今度はYを再入力して、MariaDBサーバーからデフォルトのデータベーステストを削除してください。

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サーバーがアクティブ（実行中）であることがわかります。

TYPO3 CMSのための新しいデータベースとユーザーの作成

この時点で、TYPO3 CMS のインストールのために基本的な LAMP スタックのインストールが完了しました。これから TYPO3 CMS 用の新しい MariaDB データベースとユーザーを作成します。

以下のmysqlコマンドを使用してMariaDBシェルにログインします。MariaDBのルートパスワードの入力が求められます。

mysql -u root -p

次に、以下のMariaDBクエリを実行して、ユーザーtypo3とパスワードtypo3passwordで新しいデータベースtypo3dbを作成します。

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

EXITと入力してMariaDBシェルからログアウトし、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;"

インストーラーのファイルが正しいものであることを意味する「インストーラーが確認されました」という出力メッセージを必ず確認してください。

次に、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

最後に、次のコマンドを使用してComposerのインストールを確認してください。

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

Debian 11 システムに PHP コンポーザー v2.3.3 がインストールされているのを確認でき、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

次に、/var/www/typo3 ディレクトリに移動し、以下の Composer コマンドを実行して TYPO3 CMS をサーバーにインストールします。

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

コンポーザーはTYPO3 CMSとPHPの依存関係をダウンロードします。

インストールが完了したら、ls コマンドを実行して /var/www/typo3 の下にあるすべての利用可能なファイルとディレクトリを確認してください。

ls

publicという名前のディレクトリが表示されます。これはTYPO3 CMSのデフォルトの実際のソースであり、仮想ホストの設定のDocumentRootとして使用されます。

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 
    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

Apacheの設定が正しいことを示す構文はOKというメッセージを必ず取得してください。

最後に、次のコマンドを実行してApache2サービスを再起動し、確認します。また、Apache2サービスの状態がアクティブ（実行中）であることを確認してください。

sudo systemctl restart apache2
sudo systemctl status apache2

これで、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

次に、ウェブブラウザを開いて、あなたのTYPO3 CMSインストールのドメイン名を入力します。

https://example.io/

これでTYPO3 CMSのインストールの最初のページが表示されます。インストール環境に問題がないことを確認してください。それから、緑のボタンをクリックして続けてください。

データベースの設定では、データベースのユーザー名とパスワードを入力し、次に続行をクリックしてください。

既存の空のデータベースを使用するオプションを選択し、データベース typo3db を選択して、続けるをクリックしてください。

これで、YUPO3 CMSのために管理者ユーザーとパスワードを作成し、続けるをクリックしてインストールを完了する必要があります。

TYPO3 CMSのインストールは完了しました。TYPO3バックエンドを開くボタンをクリックしてください。

TYPO3 CMSのログインページにリダイレクトされます。管理者ユーザー名とパスワードを入力し、ログインをクリックしてください。

ユーザー名とパスワードが正しいと、TYPO3 CMSの管理ダッシュボードが表示されます。

管理者ユーザーアイコンの中に、四角いメニューがあります。それをクリックすると、TYPO3 CMSインストールの詳細な環境が表示されます。

結論

おめでとうございます！最新のDebian 11 BullseyeにLAMPスタックを使用してTYPO3 CMSを正常にインストールしました。これで、TYPO3 CMSのカスタムインデックスを作成し、環境内でTYPO3 CMSの使用を拡張するためのいくつかの拡張機能を探索することができます。

Debian 11にTYPO3 CMSをインストールする方法