使用VSCode+Docker搭建PHP远程开发环境

为什么

搭建VSCode+Docker搭建PHP远程开发环境搭建,主要解决以下几个问题:

  • 微信开发调试问题。
  • 随时随地办公问题(具体参看code-server)。
  • 减少本地环境污染,PHP与Node版本可能冲突(dyld: Library not loaded: /usr/local/opt/icu4c/lib/libicui18n.64.dylib)。
  • 减少硬盘使用。

基础环境

本地

  • MacOS

  • VSCode

  • Docker Desktop

远程

  • CentOS

  • Docker CE

本机不使用MacOS,而用Windows,准备好SSH工具应该也没问题。远程服务器,推荐购买阿里云,使用*NIX系统都没有问题。

步骤

  • 配置ssh登录远程服务器

  • 安装Docker

  • 安装PHP

  • 安装Nginx

  • 配置VSCode

  • 测试

以上为使用VSCode+Docker搭建PHP远程开发环境搭建的主要过程。

配置SSH远程登录

在本机上生成密钥对,然后把公钥放到服务器相应用户的~/.ssh目录,开启服务器SSH配置。

生成密钥

进入~/.ssh如果有管理多个ssh,最好~/.ssh

mkdir ~/.ssh/aliyun
cd ~/.ssh/aliyun
ssh-keygen

系统会询问你文件名和秘钥密码,可以一路回车过去,会生成两个文件:

  • id_rsa 私钥
  • id_rsa.pub 公钥

服务器ssh配置

把上一步生成的公钥发送到服务器(scp,FillZilla等)上,然后在服务器上执行下面命令。(authenrized_keys的权限必须是600或更小,否则会连接失败)。

cat id_rsa.pub >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
chmod 700 ~/.ssh

修改服务器上的ssh配置文件,位置:/etc/ssh/sshd_config

RSAAuthentication yes
PubkeyAuthentication yes

PermitRootLogin no //禁止root登录
PasswordAuthentication yes //允许密码登录,根据你的情况设置

然后重启ssh服务

systemctl restart sshd

配置别名

Host server_alias(你的服务器别名)
 HostName test.com/192.168.1.1(域名或IP)
 Port 22
 User user
 Identifier id_rsa

保存后,登录时只需执行

ssh server_alias

安装Docker

Docker安装无特殊说明,参考官方文档进行安装即可,本机Docker可以不用启动。

本机

https://docs.docker.com/docker-for-mac/install/

远程

https://docs.docker.com/engine/install/centos/

安装PHP

因为需要安装PHP扩展,所以通过编写Dockerfile来生成镜像。通过https://hub.docker.com/_/php 可以查看相关配置。注意修改国内源,同时不要使用最新版本镜像,否则下载依赖包时可能出现问题。如下是我的 Dockerfile,大家可以参考。

FROM php:7.3-fpm
LABEL maintainer="L4qiang@gmail.com"
LABEL Description="PHP7.3开发环境"

# dependency
RUN sed -i 's#http://deb.debian.org#https://mirrors.163.com#g' /etc/apt/sources.list \
    && apt-get update \
    && apt-get install -y net-tools dnsutils inetutils-ping wget git unzip

# composer
RUN curl -sS https://getcomposer.org/installer | php
RUN mv composer.phar /usr/local/bin/composer
RUN chmod +x /usr/local/bin/composer
RUN composer config -g repo.packagist composer https://packagist.phpcomposer.com

# php-ext
RUN docker-php-ext-install -j$(nproc) bcmath calendar exif gettext sockets dba mysqli pcntl pdo_mysql shmop sysvmsg sysvsem sysvshm iconv
RUN pecl install xdebug && docker-php-ext-enable xdebug

RUN apt-get install -y --no-install-recommends libfreetype6-dev libjpeg62-turbo-dev libpng-dev \
    && docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ \
    && docker-php-ext-install -j$(nproc) gd

RUN apt-get install -y --no-install-recommends libzip-dev && \
    rm -r /var/lib/apt/lists/* && \
    docker-php-ext-install -j$(nproc) zip

构建容器

docker build -t php-dev .
docker run --name -d -p 9000:9000 -v /data/Workspace/www:/var/www/html -v /data/Workspace/log/php:/var/log/php php-dev

安装Nginx

在远程服务器用Docker安装Nginx,通过https://hub.docker.com/_/nginx 可以查看一些配置。一般会将nginx的整个配置目录 copy 到本地一份,然后在运行的时候将目录绑定到 nginx 容器的配置目录

获取配置

docker run --name tmp-nginx -d nginx
docker cp tmp-nginx:/etc/nginx /data/nginx/conf
docker rm -f tmp-nginx

修改配置

    server {
       charset utf-8;
       client_max_body_size 128M;

       listen 80; ## listen for ipv4
       server_name php.goldsyear.com;

       root /var/www/html/;
       index       index.php;

       location / {
            try_files $uri $uri/ /index.php$is_args$args;
        }

        location ~ ^/assets/.*\.php$ {
            deny all;
        }

       location ~ \.php$ {
           include fastcgi_params;
           fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
           fastcgi_pass 172.17.0.1:9000;
       }

       location ~* /\. {
           deny all;
       }
    }

注意/var/www/html/为php-dev中的地址。172.17.0.1为docker宿主网卡地址,可通过ip addr show docker0 来查看,一般为172.17.0.1

构建容器

docker run -p 80:80 --name nginx -v /data/nginx/conf:/etc/nginx -d nginx:stable

VSCode配置

安装Remote Development插件

打开VSCode,切换到插件面板,搜索Remote Development并安装,会同时安装Remote-WSL,Remote-Containers,Remote-SSH这三个插件。

配置SSH

创建工作目录,如/Users/airhead/WorkSpace/followme/docker

使用VSCode打开目录,增加.vscode\settings.json

{
    "docker.host": "ssh://root@ip",
    "terminal.integrated.shellArgs.osx": ["-s", "ssh-add ~./ssh/goldsyear-aliyun"]
}

注意,docker.host不是一个地址不能使用别名。

测试

此时切换的VSCode的Docker面板,会看到php-dev(根据自己的情况查看),右键Attach Visual St�udio Code,会打开一个新的VSCode。

打开目录/var/www/html,创建inde.php

<?php
    echo phpinfo();
?>

使用浏览器查看或用wget查看

wget http://php.goldsyear.com/index.php -O index.html
2020-05-19 16:20:51 (1.25 MB/s) - ‘index.html’ saved [99370]

总结

通过以上的配置就可以在VSCode中远程开发了,此次配置PHP远程开发环境,最容易出现问题的地方是PHP镜像的构建,可能会因为各种原因出错,要保持耐心多试几次。

参考链接

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,294评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,493评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,790评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,595评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,718评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,906评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,053评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,797评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,250评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,570评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,711评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,388评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,018评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,796评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,023评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,461评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,595评论 2 350