initial commit

.gitignore

@@ -0,0 +1,6 @@
+/.DS_Store/
+
+
+_server/var
+/vendor/
+/node_modules/

README.md

@@ -0,0 +1,27 @@
+# Docker Nginx PHP MySql
+
+## What is it?
+
+This repo is a template for setting up a local php development environment using:
+- Docker
+- Nginx
+- PHP
+- MySql
+
+For PHP, we demo with a Laravel ver 9 application, following this awesome tutorial https://www.youtube.com/watch?v=AGE3wRKljkw
+
+
+## Notices
+
+- If you want to access MySql database using 3rd-party tool like TablePlus, DataGrid,
+you should use port `33060` (not the default `3306`).
+If you want to change it, head to `docker-compose.yml`
+and update the port mapping of `db` service.
+
+- The `_server/etc` is where I store configuration files of PHP, FPM and Nginx.
+- There is a `_server/README.md` where you can see some notes for these configurations.
+- The `_server/var` is generated when we start the system.
+    - The `_server/var/lib` is where Mysql Database is stored.
+    - The `_server/var/log` is where I recieve log files.
+    - The `_server/var/run` is where the socket connection between Nginx and Php FPM is stored.
+

_server/README.md

@@ -0,0 +1,44 @@
+# Configuration Notes
+
+Collection of what to notice when configuring the PHP & Nginx.
+
+## PHP
+
+With PHP Docker, the default config location is define with `$PHP_INI_DIR`
+
+However, we want our own configuration, we will pass our configuration into
+the container by mapping volume `./_server/etc/php:/etc/php` (defined in `docker-compose.yml`)
+
+Next, we also define `entrypoint` so that we can tell `php-fpm` to use our configuration
+```yml
+app:
+  # ...
+  entrypoint:
+    - php-fpm
+    - -n
+    - -c
+    - /etc/php/php.ini
+    - -y
+    - /etc/php/php-fpm.conf
+  # ...
+```
+
+
+## NGINX
+
+We use `conf.d` instead of `sites-enabled`
+
+Since we don't need virtual host and we take advantage of `include` directive
+instead of using `soft link`
+
+Ref:
+- [conf.d vs sites-enabled](https://serverfault.com/questions/527630/difference-in-sites-available-vs-sites-enabled-vs-conf-d-directories-nginx)
+
+
+## User & Group
+
+By default PHP-FPM and Nginx use specific user/group.
+
+PHP-FPM user and group are set to `www-data` whereas Nginx user is set to `nginx` in their configurations.
+
+Read more: https://aschmelyun.com/blog/fixing-permissions-issues-with-docker-compose-and-php/

_server/etc/nginx/conf.d/default.conf

@@ -0,0 +1,25 @@
+server {
+    listen 80;
+    listen [::]:80;
+    server_name app.local www.app.local;
+
+    root /var/www/html/public;
+    index index.php index.html index.htm;
+
+    location / {
+        # try_files $uri $uri/ =404;
+        # try_files $uri $uri/ /index.php?$query_string;
+        try_files $uri /index.php?$query_string;
+    }
+
+    location ~ \.php$ {
+        try_files $uri =404;
+        fastcgi_pass unix:/var/run/php/php8-fpm.sock;
+        fastcgi_split_path_info ^(.+\.php)(/.+)$;
+        include fastcgi_params;
+        fastcgi_index index.php;
+        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+        fastcgi_param PATH_INFO $fastcgi_path_info;
+    }
+}
+

_server/etc/nginx/nginx.conf

@@ -0,0 +1,22 @@
+error_log /var/log/nginx/error.log notice;
+pid /var/run/nginx.pid;
+# user nginx;
+worker_processes auto;
+
+events {
+    worker_connections 1024;
+}
+
+http {
+    default_type application/octet-stream;
+    gzip on;
+    include /etc/nginx/mime.types;
+    include /etc/nginx/conf.d/*.conf;
+    keepalive_timeout 65;
+    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
+                    '$status $body_bytes_sent "$http_referer" '
+                    '"$http_user_agent" "$http_x_forwarded_for"';
+    access_log /var/log/nginx/access.log main;
+    sendfile on;
+}
+

_server/etc/php/php-fpm.conf

@@ -0,0 +1,143 @@
+;;;;;;;;;;;;;;;;;;;;;
+; FPM Configuration ;
+;;;;;;;;;;;;;;;;;;;;;
+
+; All relative paths in this configuration file are relative to PHP's install
+; prefix (/usr). This prefix can be dynamically changed by using the
+; '-p' argument from the command line.
+
+;;;;;;;;;;;;;;;;;;
+; Global Options ;
+;;;;;;;;;;;;;;;;;;
+
+[global]
+; Pid file
+; Note: the default prefix is /var
+; Default Value: none
+;pid = run/php-fpm8.pid
+
+; Error log file
+; If it's set to "syslog", log is sent to syslogd instead of being written
+; into a local file.
+; Note: the default prefix is /var
+; Default Value: log/php8/error.log
+;error_log = log/php8/error.log
+
+; syslog_facility is used to specify what type of program is logging the
+; message. This lets syslogd specify that messages from different facilities
+; will be handled differently.
+; See syslog(3) for possible values (ex daemon equiv LOG_DAEMON)
+; Default Value: daemon
+;syslog.facility = daemon
+
+; syslog_ident is prepended to every message. If you have multiple FPM
+; instances running on the same server, you can change the default value
+; which must suit common needs.
+; Default Value: php-fpm8
+;syslog.ident = php-fpm8
+
+; Log level
+; Possible Values: alert, error, warning, notice, debug
+; Default Value: notice
+;log_level = notice
+
+; Log limit on number of characters in the single line (log entry). If the
+; line is over the limit, it is wrapped on multiple lines. The limit is for
+; all logged characters including message prefix and suffix if present. However
+; the new line character does not count into it as it is present only when
+; logging to a file descriptor. It means the new line character is not present
+; when logging to syslog.
+; Default Value: 1024
+;log_limit = 4096
+
+; Log buffering specifies if the log line is buffered which means that the
+; line is written in a single write operation. If the value is false, then the
+; data is written directly into the file descriptor. It is an experimental
+; option that can potentionaly improve logging performance and memory usage
+; for some heavy logging scenarios. This option is ignored if logging to syslog
+; as it has to be always buffered.
+; Default value: yes
+;log_buffering = no
+
+; If this number of child processes exit with SIGSEGV or SIGBUS within the time
+; interval set by emergency_restart_interval then FPM will restart. A value
+; of '0' means 'Off'.
+; Default Value: 0
+;emergency_restart_threshold = 0
+
+; Interval of time used by emergency_restart_interval to determine when
+; a graceful restart will be initiated.  This can be useful to work around
+; accidental corruptions in an accelerator's shared memory.
+; Available Units: s(econds), m(inutes), h(ours), or d(ays)
+; Default Unit: seconds
+; Default Value: 0
+;emergency_restart_interval = 0
+
+; Time limit for child processes to wait for a reaction on signals from master.
+; Available units: s(econds), m(inutes), h(ours), or d(ays)
+; Default Unit: seconds
+; Default Value: 0
+;process_control_timeout = 0
+
+; The maximum number of processes FPM will fork. This has been designed to control
+; the global number of processes when using dynamic PM within a lot of pools.
+; Use it with caution.
+; Note: A value of 0 indicates no limit
+; Default Value: 0
+; process.max = 128
+
+; Specify the nice(2) priority to apply to the master process (only if set)
+; The value can vary from -19 (highest priority) to 20 (lowest priority)
+; Note: - It will only work if the FPM master process is launched as root
+;       - The pool process will inherit the master process priority
+;         unless specified otherwise
+; Default Value: no set
+; process.priority = -19
+
+; Send FPM to background. Set to 'no' to keep FPM in foreground for debugging.
+; Default Value: yes
+daemonize = no
+
+; Set open file descriptor rlimit for the master process.
+; Default Value: system defined value
+;rlimit_files = 1024
+
+; Set max core size rlimit for the master process.
+; Possible Values: 'unlimited' or an integer greater or equal to 0
+; Default Value: system defined value
+;rlimit_core = 0
+
+; Specify the event mechanism FPM will use. The following is available:
+; - select     (any POSIX os)
+; - poll       (any POSIX os)
+; - epoll      (linux >= 2.5.44)
+; - kqueue     (FreeBSD >= 4.1, OpenBSD >= 2.9, NetBSD >= 2.0)
+; - /dev/poll  (Solaris >= 7)
+; - port       (Solaris >= 10)
+; Default Value: not set (auto detection)
+;events.mechanism = epoll
+
+; When FPM is built with systemd integration, specify the interval,
+; in seconds, between health report notification to systemd.
+; Set to 0 to disable.
+; Available Units: s(econds), m(inutes), h(ours)
+; Default Unit: seconds
+; Default value: 10
+;systemd_interval = 10
+
+;;;;;;;;;;;;;;;;;;;;
+; Pool Definitions ;
+;;;;;;;;;;;;;;;;;;;;
+
+; Multiple pools of child processes may be started with different listening
+; ports and different management options.  The name of the pool will be
+; used in logs and stats. There is no limitation on the number of pools which
+; FPM can handle. Your system will tell you anyway :)
+
+; Include one or more files. If glob(3) exists, it is used to include a bunch of
+; files from a glob(3) pattern. This directive can be used everywhere in the
+; file.
+; Relative path can also be used. They will be prefixed by:
+;  - the global prefix if it's been set (-p argument)
+;  - /usr otherwise
+include=/etc/php/php-fpm.d/*.conf