ApacheでPHPとMySQLの連携環境を簡単に構築する方法【初心者向け】

Apacheを使用してPHPとMySQLが連携する環境を構築することは、Webアプリケーション開発において非常に重要です。この環境は一般的に「LAMP環境(Linux, Apache, MySQL, PHP)」と呼ばれ、動的なWebサイトやWebサービスを構築する際の基盤となります。

LAMP環境の構築は、一見難しそうに感じるかもしれませんが、正しい手順を踏めば初心者でも簡単にセットアップできます。本記事では、Linux環境をベースに、ApacheでPHPとMySQLを連携させる方法を分かりやすく解説します。

これから説明する手順を実践することで、PHPで作成したWebアプリケーションがMySQLデータベースにアクセスできるようになり、より高度で柔軟なWebサービスの開発が可能になります。

具体的には、Apacheのインストールから設定、PHPとMySQLのインストール、そして三者が正しく連携するように設定する方法を順を追って解説します。また、環境構築中によくあるエラーやトラブルシューティングについても触れますので、安心して進めてください。

目次

LAMP環境とは何か


LAMP環境は、Linuxをオペレーティングシステムとして、ApacheをWebサーバー、MySQLをデータベース管理システム、PHPをサーバーサイドスクリプト言語として組み合わせたWeb開発環境です。これらの技術スタックは、動的なWebサイトやWebアプリケーションを開発するための標準的な構成として広く使用されています。

LAMPの構成要素

  • Linux:オープンソースのオペレーティングシステムで、LAMP環境の基盤となります。安定性とセキュリティの高さが特徴です。
  • Apache:世界で最も普及しているWebサーバーソフトウェアです。HTTPリクエストを処理し、クライアントにWebページを配信します。
  • MySQL:リレーショナルデータベース管理システム(RDBMS)で、大量のデータを効率的に管理し、PHPなどのプログラムからクエリを通じて操作できます。
  • PHP:動的なWebページを作成するためのプログラミング言語です。HTMLと簡単に統合でき、データベースと連携したコンテンツ生成が可能です。

LAMP環境のメリット

  • オープンソースであるため、コストを抑えてWeb開発環境を構築できます。
  • 柔軟性が高く、プロジェクトの規模を問わず適用可能です。
  • 豊富なドキュメントとコミュニティが存在し、トラブル時の解決手段が豊富です。

LAMP環境は、WordPressやDrupalなどのCMS(コンテンツ管理システム)にも使用されており、Web開発初心者から上級者まで幅広く支持されています。

必要なソフトウェアのインストール準備


LAMP環境を構築するためには、Apache、PHP、MySQLの3つの主要コンポーネントをインストールする必要があります。その前に、Linux環境の準備とソフトウェアのインストールがスムーズに進むように必要なパッケージや依存関係を確認しましょう。

システムの更新と必要パッケージの確認


まず、システムが最新の状態であることを確認し、必要なパッケージをインストールします。以下のコマンドを実行して、システムを最新の状態にします。

sudo apt update && sudo apt upgrade -y


次に、ApacheやPHPのインストールに必要なパッケージを追加します。

sudo apt install software-properties-common -y

ファイアウォールの設定確認


Apacheが外部からのリクエストを受けられるように、ファイアウォールの設定を調整します。以下のコマンドでApacheが許可されていることを確認します。

sudo ufw allow 'Apache Full'
sudo ufw reload


ファイアウォールの状態を確認するには、以下のコマンドを実行します。

sudo ufw status

Linuxディストリビューション別の注意点

  • Ubuntu/Debian系aptコマンドを使用します。
  • CentOS/RHEL系yumまたはdnfコマンドを使用します。

この準備を終えた後、Apache、PHP、MySQLのインストールに進むことができます。事前にシステムがクリーンな状態であることを確認し、不要なトラブルを回避しましょう。

Apacheのインストールと初期設定


ApacheはLAMP環境の中核となるWebサーバーです。ここではApacheのインストール方法と、基本的な初期設定、動作確認の手順について解説します。

Apacheのインストール


UbuntuやDebian系Linuxでは、以下のコマンドでApacheをインストールします。

sudo apt install apache2 -y


CentOSやRHEL系では、次のコマンドを使用します。

sudo yum install httpd -y

Apacheの起動と自動起動設定


インストールが完了したら、Apacheを起動し、システム起動時に自動的に起動するよう設定します。
Ubuntu/Debian系

sudo systemctl start apache2
sudo systemctl enable apache2


CentOS/RHEL系

sudo systemctl start httpd
sudo systemctl enable httpd

Apacheの動作確認


Apacheが正常に動作しているか確認します。Webブラウザを開き、サーバーのIPアドレスを入力します。

http://<サーバーのIPアドレス>  


「Apache2 Debian Default Page」または「Test Page for Apache HTTP Server」が表示されれば、Apacheは正常に動作しています。

Apacheの設定ファイルの確認と基本設定


Apacheの設定ファイルは以下のディレクトリにあります。
Ubuntu/Debian系

/etc/apache2/apache2.conf  


CentOS/RHEL系

/etc/httpd/conf/httpd.conf  


基本設定を行うために、以下のコマンドでファイルを編集します。

sudo nano /etc/apache2/apache2.conf


もしくは

sudo nano /etc/httpd/conf/httpd.conf

デフォルトページの無効化


必要に応じてデフォルトのインデックスページを無効化します。

sudo rm /var/www/html/index.html

この設定により、Apacheの基本的な動作環境が整います。次のステップでは、PHPをインストールしてApacheと連携させます。

PHPのインストールとApacheの連携設定


PHPは動的なWebページを生成するためのスクリプト言語で、Apacheと連携することで、MySQLデータベースとやり取りを行うWebアプリケーションを構築できます。ここではPHPのインストール方法とApacheとの連携設定を解説します。

PHPのインストール


UbuntuやDebian系のLinuxでは以下のコマンドでPHPをインストールします。

sudo apt install php libapache2-mod-php php-mysql -y


CentOSやRHEL系では、次のコマンドを使用します。

sudo yum install php php-mysql -y

PHPのバージョン確認


インストール後、PHPが正しくインストールされたことを確認します。

php -v


インストール済みのPHPのバージョンが表示されれば正常です。

Apacheとの連携設定


PHPがインストールされただけではApacheと連携しません。ApacheにPHPを解釈させるように設定を行います。

Ubuntu/Debian系
PHPモジュールが有効になっていることを確認します。

sudo a2enmod php


Apacheを再起動して設定を反映します。

sudo systemctl restart apache2

CentOS/RHEL系
ApacheがPHPファイルを処理できるよう、設定ファイルを編集します。

sudo nano /etc/httpd/conf/httpd.conf


以下の行があることを確認し、なければ追加します。

AddType application/x-httpd-php .php
DirectoryIndex index.php index.html


Apacheを再起動します。

sudo systemctl restart httpd

動作確認


PHPが正しく動作しているか確認するため、PHPのテストページを作成します。

sudo nano /var/www/html/info.php


以下の内容を記述して保存します。

<?php
phpinfo();
?>


ブラウザで以下のURLにアクセスします。

http://<サーバーのIPアドレス>/info.php  


PHPの設定情報が表示されれば、ApacheとPHPの連携は完了です。
次のステップでは、MySQLのインストールと初期設定を行います。

MySQLのインストールと初期設定


MySQLはLAMP環境におけるデータベース管理システムで、PHPと連携して動的なWebアプリケーションのバックエンドを構築します。ここではMySQLのインストール手順と、セキュリティを確保するための初期設定について解説します。

MySQLのインストール


Ubuntu/Debian系

sudo apt install mysql-server -y


CentOS/RHEL系

sudo yum install mysql-server -y


インストールが完了したら、MySQLサービスを起動して自動起動を設定します。

sudo systemctl start mysql
sudo systemctl enable mysql

MySQLのセキュリティ設定


インストール直後のMySQLは最低限の設定しかされていません。セキュリティを強化するため、以下のコマンドで初期設定を行います。

sudo mysql_secure_installation


設定手順例

  • 現在のrootパスワード:なしでEnter(初回インストール時)
  • 新しいrootパスワードを設定
  • 匿名ユーザーの削除
  • rootユーザーのリモートログイン無効化
  • テストデータベースの削除
  • 権限テーブルの再読み込み

これでMySQLの基本的なセキュリティ設定が完了します。

MySQLへのログインとユーザー作成


以下のコマンドでMySQLにrootユーザーとしてログインします。

sudo mysql -u root -p


パスワードを入力してログイン後、新しいデータベースとユーザーを作成します。

CREATE DATABASE webapp_db;
CREATE USER 'webuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON webapp_db.* TO 'webuser'@'localhost';
FLUSH PRIVILEGES;


この設定により、「webapp_db」という名前のデータベースが作成され、「webuser」というユーザーがアクセス可能になります。

MySQLの動作確認


データベースが正しく作成されたか確認します。

SHOW DATABASES;


「webapp_db」が表示されれば、MySQLの初期設定は完了です。
次のステップでは、PHPからMySQLに接続して動作確認を行います。

PHPからMySQLへの接続確認


PHPがMySQLデータベースに正しく接続できるかを確認することは、LAMP環境の構築において重要なステップです。ここでは、PHPスクリプトを使用してMySQLへの接続テストを行い、クエリを実行する方法を解説します。

テスト用のPHPスクリプト作成


MySQLデータベースへの接続を確認するためのPHPファイルを作成します。

sudo nano /var/www/html/db_test.php


以下のコードを記述して保存します。

<?php
$servername = "localhost";
$username = "webuser";
$password = "password";
$dbname = "webapp_db";

// MySQLに接続
$conn = new mysqli($servername, $username, $password, $dbname);

// 接続確認
if ($conn->connect_error) {
    die("接続失敗: " . $conn->connect_error);
}
echo "接続成功!";

// 簡単なクエリの実行
$sql = "SELECT DATABASE()";
$result = $conn->query($sql);

if ($result->num_rows > 0) {
    while($row = $result->fetch_assoc()) {
        echo "使用中のデータベース: " . $row["DATABASE()"];
    }
} else {
    echo "クエリの結果がありません";
}
$conn->close();
?>

ブラウザで接続確認


ブラウザを開き、以下のURLにアクセスします。

http://<サーバーのIPアドレス>/db_test.php  


「接続成功!」と表示され、データベース名が表示されれば、PHPからMySQLへの接続が正常に行われています。

接続エラーが出た場合の対処

  • 「接続失敗」と表示される場合は、以下を確認してください。
  • ユーザー名、パスワードが正しいか。
  • MySQLで該当ユーザーに権限が付与されているか。
  • MySQLサービスが起動しているか。
  • 以下のコマンドでMySQLの状態を確認します。
sudo systemctl status mysql


サービスが停止している場合は、次のコマンドで再起動します。

sudo systemctl restart mysql

セキュリティのための対策


テストが完了したら、セキュリティを確保するためにテスト用スクリプトを削除します。

sudo rm /var/www/html/db_test.php

次のステップでは、Apache、PHP、MySQLの連携を動作テストで確認します。

ApacheとPHP、MySQLの動作テスト


LAMP環境が正しく構築されているかを確認するために、Apache、PHP、MySQLが連携して動作しているかテストを行います。ここでは、簡単なPHPスクリプトを使用して、MySQLデータベースからデータを取得し、ブラウザに表示させる方法を解説します。

テスト用のデータベーステーブル作成


まず、MySQLにログインし、テスト用のテーブルとデータを作成します。

sudo mysql -u root -p


以下のSQLコマンドを実行します。

USE webapp_db;

CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    email VARCHAR(100) NOT NULL
);

INSERT INTO users (name, email) VALUES
('山田 太郎', 'taro@example.com'),
('佐藤 花子', 'hanako@example.com');


これで、usersテーブルに2件のデータが登録されました。

PHPからデータを取得するスクリプト


次に、PHPでMySQLからデータを取得して表示するスクリプトを作成します。

sudo nano /var/www/html/users.php


以下のコードを記述します。

<?php
$servername = "localhost";
$username = "webuser";
$password = "password";
$dbname = "webapp_db";

// データベースに接続
$conn = new mysqli($servername, $username, $password, $dbname);

// 接続確認
if ($conn->connect_error) {
    die("接続失敗: " . $conn->connect_error);
}

// データを取得
$sql = "SELECT * FROM users";
$result = $conn->query($sql);

if ($result->num_rows > 0) {
    echo "<h2>ユーザー一覧</h2>";
    while($row = $result->fetch_assoc()) {
        echo "ID: " . $row["id"] . " - 名前: " . $row["name"] . " - メール: " . $row["email"] . "<br>";
    }
} else {
    echo "ユーザーが見つかりませんでした。";
}
$conn->close();
?>

動作確認


ブラウザで以下のURLにアクセスします。

http://<サーバーのIPアドレス>/users.php  


データベースに登録したユーザー一覧が表示されれば、Apache、PHP、MySQLの連携は成功です。

表示されない場合のトラブルシューティング

  1. データが表示されない場合
  • usersテーブルにデータが正しく登録されているか確認します。
   SELECT * FROM users;
  1. 接続失敗のエラーが表示される場合
  • MySQLのユーザー権限を確認し、webuserに必要な権限が付与されているか確認します。
   SHOW GRANTS FOR 'webuser'@'localhost';
  • 必要に応じて以下のコマンドで再付与します。
   GRANT ALL PRIVILEGES ON webapp_db.* TO 'webuser'@'localhost';
   FLUSH PRIVILEGES;
  1. Apacheが動作していない場合
  • Apacheが起動しているか確認します。
   sudo systemctl status apache2
  • 起動していない場合は再起動します。
   sudo systemctl restart apache2

動作確認が終わったら、不要なPHPファイルは削除して環境をクリーンに保ちます。

sudo rm /var/www/html/users.php

トラブルシューティングとよくある問題の解決方法


LAMP環境の構築中や動作確認時には、さまざまなエラーや問題が発生する可能性があります。ここでは、よくある問題とその解決方法について解説します。

Apacheが起動しない


エラー例:

Job for apache2.service failed. See "systemctl status apache2" and "journalctl -xe" for details.  


原因と対処方法:

  • 設定ファイルに記述ミスがある可能性があります。設定ファイルを確認します。
sudo apachectl configtest
  • エラーが表示された場合は、設定ファイルを修正します。
sudo nano /etc/apache2/apache2.conf
  • 修正後、Apacheを再起動します。
sudo systemctl restart apache2

PHPスクリプトが動作しない


症状: ブラウザでPHPファイルにアクセスするとソースコードがそのまま表示される。
原因と対処方法:

  • ApacheがPHPを解釈していない可能性があります。PHPモジュールが有効か確認します。
sudo a2enmod php
sudo systemctl restart apache2
  • PHPがインストールされていない場合はインストールします。
sudo apt install php libapache2-mod-php -y

MySQLに接続できない


エラー例:

Access denied for user 'webuser'@'localhost' (using password: YES)  


原因と対処方法:

  • ユーザー名またはパスワードが間違っている可能性があります。ユーザー情報を確認します。
SELECT user, host FROM mysql.user;
  • ユーザーに適切な権限が付与されているか確認し、権限を付与します。
GRANT ALL PRIVILEGES ON webapp_db.* TO 'webuser'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

403 Forbiddenエラーが表示される


原因と対処方法:

  • Apacheのドキュメントルートの権限が不足している可能性があります。以下のコマンドで権限を修正します。
sudo chown -R www-data:www-data /var/www/html
sudo chmod -R 755 /var/www/html
  • Directoryディレクティブの設定を確認します。
sudo nano /etc/apache2/apache2.conf


以下の設定があることを確認し、存在しない場合は追記します。

<Directory /var/www/html>
    AllowOverride All
    Require all granted
</Directory>


Apacheを再起動して変更を反映します。

sudo systemctl restart apache2

データベースクエリが失敗する


エラー例:

Table 'webapp_db.users' doesn't exist  


原因と対処方法:

  • テーブルが存在しない可能性があります。データベースを確認してテーブルを作成します。
SHOW TABLES;
  • テーブルが存在しない場合は再作成します。
CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    email VARCHAR(100) NOT NULL
);

まとめ


これらのトラブルシューティング方法を活用することで、LAMP環境の構築や運用において発生する問題を迅速に解決できます。問題が発生した場合はエラーメッセージを注意深く確認し、順番に対処することが重要です。

まとめ


本記事では、Apacheを使用してPHPとMySQLが連携するLAMP環境の構築方法について解説しました。ApacheのインストールからPHPとMySQLの設定、接続テストまでの流れを順を追って説明し、動作確認やトラブルシューティングについても触れました。

LAMP環境を構築することで、動的なWebサイトやアプリケーションを効率的に開発できるようになります。特にPHPとMySQLの連携は、フォームからのデータ送信やユーザー管理など、多くのWebアプリケーションで不可欠な機能です。

設定が完了した後は、セキュリティ対策や定期的なアップデートを忘れずに行い、安定した環境を維持しましょう。LAMP環境をマスターすることで、さまざまなWebサービスの開発が可能になります。

コメント

コメントする

目次