docker架构下LNMP环境遇到 index.php 报错”File not found.”

1.0 问题描述

在搭建服务器时,很多时候都会部署 LNMP (Linux+Nginx+Mysql+PHP) 环境,如果是把环境直接安装在服务器上,则不容易出现此问题,但是如果是通过 Docker 分别搭建的 LNMP 组件(步骤),那么在配置 web 服务时,则有可能出现下面的问题。

问题:当需要部署多个 web 应用,尤其是需要增加一个 web 应用时,有时需要在 nginx/conf.d 中新配置一个根目录,用以部署代码资源。如果此时忘了对 php 进行根目录的配置,就会使得 index.html 等 HTML 资源可以被找到访问,而 index.php 等 PHP 资源则会在浏览器报错 File not found.

2.0 分析与解决

2.1 分析

我们看一个典型的 nginx 配置文件。

server {
    listen       your_port;
    listen  [::]:your_port;
    server_name  localhost;

    #access_log  /var/log/nginx/host.access.log  main;

    location / {
        root   web_root_path;
        index  index.php index.html index.htm;
    }

    #error_page  404              /404.html;

    # redirect server error pages to the static page /50x.html
    #
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }

    # proxy the PHP scripts to Apache listening on 127.0.0.1:80
    #
    #location ~ \.php$ {
    #    proxy_pass   http://127.0.0.1;
    #}

    # pass the PHP scripts to FastCGI server listening on 127.0.0.1:php_port
    #
    location ~ \.php$ {
         root   web_root_path;
         fastcgi_pass   localhost:php_port;
         fastcgi_index  index.php;
    #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
         fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
     fastcgi_param  SCRIPT_NAME      $fastcgi_script_name;
         include        fastcgi_params;
    }

    # deny access to .htaccess files, if Apache's document root
    # concurs with nginx's one
    #
    #location ~ /\.ht {
    #    deny  all;
    #}
}

其中和我们的资源根目录相关的是这两处代码:

    # Web root path
    location / {
        root   web_root_path;       # <---- WATCH THIS 
        index  index.php index.html index.htm;
    }


    # pass the PHP scripts to FastCGI server listening on 127.0.0.1:php_port
    #
    location ~ \.php$ {
         root   web_root_path;      # <---- WATCH THIS
         fastcgi_pass   localhost:php_port;
         fastcgi_index  index.php;
    #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
         fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
     fastcgi_param  SCRIPT_NAME      $fastcgi_script_name;
         include        fastcgi_params;
    }

在 docker 配置的环境下,为了增加一个根目录,我们一般会想起来为 nginx 容器新加一个挂载,把物理机的某个目录挂载在容器的 web_root_path 下,这一步保证了 index.html 等 HTML 资源可以被访问到;
但是如果忘了把物理机目录同样挂载在 PHP 容器的 web_root_path 下的话,就会导致 index.php 等 PHP 资源不能被找到,从而报错 File not found.

2.2 解决

解决方式就是注意要对 nginx 和 PHP 容器,均配置新的 根目录挂载。
以 docker compose 搭建的 LNMP 为例,要在 docker-compose.yml 中在 nginx 和 PHP 两个部分添加新的挂载条目:

# Creat LNMP + phpmyadmin containers
version: '3'
services:
  php-fpm:
    image: php:7.4-fpm
    container_name: php
    restart: unless-stopped
    volumes:
      - old_path ... 
      - server_path:web_root_path       # <---- WATCH THIS 
    ports:
      - php_port_set

  nginx:
    image: nginx
    container_name: nginx
    restart: unless-stopped
    depends_on:
      - php-fpm
    volumes:
      - old_path ...
      - server_path:web_root_path       # <---- WATCH THIS 
    ports:
      - nginx_port_set

只需要关注标注的两条 volumes 配置代码。他们把物理机上的 web 资源目录 server_path 同时挂载在了 nginx 和 PHP 容器内部。这保证了 HTML 和 PHP 资源均可以被访问到。
修改好 yaml 文件后执行:

docker compose down         # Destroy old LNMP  
docker compose up -d        # Create new LNMP

此时再去访问 index.php 就发现可以成功访问到,而不会报错了。