详解如何使用PhpStorm+Docker搭建开发环境

1. 简介

在软件开发中使用Docker可以方便地构建开发环境，提高开发效率和可移植性。PhpStorm是一款常用的PHP开发工具，可以与Docker结合使用来构建开发环境。本文将详细介绍如何使用PhpStorm和Docker搭建PHP开发环境。

2. 安装Docker

Docker是一个开源的容器化平台，可以帮助开发人员构建、运行和管理应用程序。下面介绍如何在Ubuntu系统上安装Docker。

2.1 安装Docker Engine

首先需要安装Docker Engine，可以按照官方文档提示进行安装，下面给出Ubuntu系统上的安装步骤。

sudo apt update

sudo apt install docker.io

安装完成后，运行以下命令检查Docker是否安装成功。

docker --version

2.2 安装Docker Compose

Docker Compose是一个用于定义和运行多个容器的工具，可以通过一个YAML文件配置应用的服务。下面是Ubuntu系统上安装Docker Compose的步骤。

sudo apt-get update

sudo apt-get install docker-compose

安装完成后，运行以下命令检查Docker Compose是否安装成功。

docker-compose --version

3. 安装PhpStorm

PhpStorm是一款强大的PHP开发工具，开发人员可以使用它来编写和调试PHP代码。下面是PhpStorm安装的步骤。

3.1 下载PhpStorm

首先需要下载PhpStorm的安装包。可以到官网进行下载，也可以使用wget命令从命令行下载最新版本。

wget https://download.jetbrains.com/webide/PhpStorm-2021.1.2.tar.gz

3.2 解压安装包

下载完成后，解压安装包到目标目录。

tar -xzf PhpStorm-2021.1.2.tar.gz -C /opt/

3.3 启动PhpStorm

解压完成后，可以使用以下命令启动PhpStorm。

/opt/PhpStorm-2021.1.2/bin/phpstorm.sh

4. 创建Docker镜像

在使用Docker构建开发环境时，需要先创建一个Docker镜像，该镜像包含配置好的PHP、Apache和MySQL环境。

4.1 创建Dockerfile

在项目根目录下创建一个名为Dockerfile的文件。该文件定义了构建Docker镜像时需要执行的命令。

FROM php:7.4-apache

RUN docker-php-ext-install mysqli
COPY php.ini /usr/local/etc/php/
COPY apache.conf /etc/apache2/sites-available/000-default.conf
RUN a2enmod rewrite

上述代码执行了以下几个步骤：

从官方的php:7.4-apache镜像构建一个新镜像。

安装MySQLi扩展。

复制php.ini文件到容器中的/usr/local/etc/php/目录中。

复制Apache配置文件到容器中的/etc/apache2/sites-available/目录中。

启用Apache的rewrite模块。

4.2 创建docker-compose.yml

docker-compose.yml文件定义了多个容器的配置信息，包括PHP、Apache和MySQL容器。

version: '3'

services:
  web:
    build: .
    ports:
      - "80:80"
    volumes:
      - .:/var/www/html
    depends_on:
      - db
  db:
    image: mysql:8
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: test
    ports:
      - "3306:3306"
    expose:
      - "3306"

上述代码执行以下操作：

创建web容器，并将当前目录映射到容器的/var/www/html目录中。

创建db容器，并开放端口3306用于远程访问MySQL。

4.3 构建Docker镜像

执行以下命令构建Docker镜像。

docker-compose build

4.4 启动Docker容器

执行以下命令启动Docker容器。

docker-compose up

启动后可以通过http://localhost访问PHP应用程序。

5. 将PhpStorm连接到Docker容器

现在可以将PhpStorm连接到上面创建的Docker容器，以便在PhpStorm中编写和调试代码。

5.1 配置PhpStorm

打开PhpStorm并选择“File”-“Settings”，在打开的窗口中选择“PHP”。

将“Interpreter”设置为“Docker”。

在“Docker”下面，点击“Add”按钮并选择“Docker Compose”。

选择docker-compose.yml文件并点击“OK”按钮。

选择“php:7.4-apache”映像并点击“OK”按钮。

5.2 配置运行/调试

在PhpStorm中设置运行/调试配置，以便可以运行和调试代码。

选择“Run”菜单-“Edit Configurations”。

选择“PHP Built-in Web Server”。

设置“Host”为“localhost”。

设置“Port”为“80”。

设置“Document root”为“/var/www/html”。

现在可以启动调试器并开始调试代码了。

6. 总结

在本文中，我们介绍了如何使用PhpStorm和Docker搭建PHP开发环境。首先安装Docker和PhpStorm，然后创建Docker镜像和容器，最后将PhpStorm连接到Docker容器并设置运行/调试配置。使用这种方法可以方便地构建和管理开发环境，提高开发效率和可移植性。