Pada tutorial kali ini saya akan berbagi untuk membuat aplikasi Laravel PHP termasuk NginX Docker container. Dengan Docker, kita tidak perlu menginstall aplikasi apapun di dalam laptop kecuali Docker.
Laravel adalah PHP Framework yang paling populer, namun terkadang sulit untuk melakukan setup bagi orang yang pertama kali mengenal Laravel. Kalau kita membuka halaman awal cara untuk menginstall laravel, akan terdapat list apa saja tools yang perlu diinstal. Menginstall PHP tidak sederhana. Karena itu, menggunakan Docker akan sangat membantu kita jika ingin menjalankan Laravel.
Di tutorial ini kita akan membuat container untuk PHP interpreter, Nginx Server, dan MySQL Database untuk menyimpan data. Container lain yang akan kita siapkan adalah Composer package manager untuk install dependendecy, Laravel artisan container, dan npm container.
1. Membuat Container NginX
Nginx container sebagai web server. Pertama kali kita akan membuat file docker-compose.yaml dan mengatur service nginx server.
Service nginx menggunakan official image dari docker dengan versi stable-alpine. Dari docker documentation, nginx juga mengekspose port 80. Service ini akan melihat request yang datang untuk dihubungkan ke container php untuk mengeksekusi kode php. Untuk menambah konfigurasi ini, kita akan menambahkan volumes. Dari dokumentasinya, kita akan menambahkan di folder etc, sehingga menjadi seperti ini: – ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
Buat folder baru, ‘nginx’, dan di dalamnya buat file baru nginx.conf
nginx.conf
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
server { listen 80; index index.php index.html; server_name localhost; root /var/www/html/public; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { try_files $uri =404; fastcgi_split_path_info ^(.+\.php)(/.+)$; fastcgi_pass php:9000; fastcgi_index index.php; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param PATH_INFO $fastcgi_path_info; } } |
2. Membuat PHP Container
Selain php, kita akan menginstall juga beberapa extension yang dibutuhkan Laravel. Untuk itu, kita akan membuat sebuah Dockerfile. Buat folder baru dockerfile, didalamnya buat file baru, php.dockerfile.
php.dockerfile
|
1 2 3 4 5 |
FROM php:8.1.5-fpm-alpine3.15 WORKDIR /var/www/html RUN docker-php-ext-install pdo pdo_mysql |
Edit docker-compose.yaml untuk menambahkan php container.
Buat source folder di root, ‘src’ untuk ditambahkan di volume pada php container.
Sehingga docker-compose.yaml menjadi:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
version: "3.8" services: server: image: 'nginx:stable-alpine' ports: - '8000:80' volumes: - ./nginx/nginx.conf:/etc/nginx/conf.d/default.conf:ro php: build: context: ./dockerfiles dockerfile: php.dockerfile volumes: - ./src:/var/www/html:delegated |
3. Membuat MySQL Container
Saat membuat MySQL Container, kita perlu menambahkan environment variables misalnya untuk user, password. Environment variabel tersebut akan kita tambahkan bukan di docker-compose.yml tapi di file mysql.env di dalam folder env yang akan kita buat.
mysql.env
|
1 2 3 4 |
MYSQL_DATABASE=homestead MYSQL_USER=homestead MYSQL_PASSWORD=secret MYSQL_ROOT_PASSWORD=secret |
Di dalam docker-compose kita akan membuat env_file yang menunjukkan dimana tempat environment variabelnya berada:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
version: "3.8" services: server: image: 'nginx:stable-alpine' ports: - '8000:80' volumes: - ./nginx/nginx.conf:/etc/nginx/conf.d/default.conf:ro php: build: context: ./dockerfiles dockerfile: php.dockerfile volumes: - ./src:/var/www/html:delegated mysql: image: mysql:5.7 env_file: - ./env/mysql.env |
4. Membuat Utility Container – Composer
Untuk membuat container ini, kita akan membuat satu dockerfile baru karena perlu ada beberapa tambahan dari yang image composer yang original.
dockerfiles/composer.dockerfile
|
1 2 3 4 5 |
FROM composer:latest WORKDIR /var/www/html ENTRYPOINT ["composer", "--ignore-platform-reqs"] |
ENTRYPOINT [“composer”, “–ignore-platform-reqs”] dimaksudkan supaya tidak ada error warning meskipun dependencynya tidak ada.
Kita juga menambahkan volumes supaya terjadi mirroring apa yang terjadi di folder src di local computer itu sama dengan yang terjadi di folder /var/www/html yang berada di dalam container.
docker-compose.yml
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
version: "3.8" services: server: image: 'nginx:stable-alpine' ports: - '8000:80' volumes: - ./nginx/nginx.conf:/etc/nginx/conf.d/default.conf:ro php: build: context: ./dockerfiles dockerfile: php.dockerfile volumes: - ./src:/var/www/html:delegated mysql: image: mysql:5.7 env_file: - ./env/mysql.env composer: build: context: ./dockerfiles dockerfile: composer.dockerfile volumes: - ./src:/var/www/html |
5. Membuat Aplikasi Laravel dengan Composer
Kita dapat menjalankan masing2 service di dalam file docker-compose.yaml dengan perintah docker-compose run. Kita akan coba menjalankan composer service dengan perintah berikut:
|
1 |
docker-compose run --rm composer create-project --prefer-dist laravel/laravel . |
–rm digunakan untuk meremove semua resource apabila container di hentikan.
Setelah perintah dijalankan dan selesai proses instalasi, di folder src akan terisi folder2 aplikasi laravel.
6. Launching Aplikasi dari Docker
Di dalam folder src terdapat file .env. Kita akan fokus pada informasi database:
|
1 2 3 4 5 6 |
DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=laravel DB_USERNAME=root DB_PASSWORD= |
Sebelumnya, kita sudah membuat file mysql.env, sesuaikan info db dengan file tersebut dan ganti host dengan nama service di docker-compose.yml sehingga menjadi seperti ini:
|
1 2 3 4 5 6 |
DB_CONNECTION=mysql DB_HOST=mysql DB_PORT=3306 DB_DATABASE=homestead DB_USERNAME=homestead DB_PASSWORD=secret |
Sebelum menjalankan aplikasi, kita perlu mengupdate docker-compose.yaml file untuk menambahkan volume di service server. Karena server adalah yang pertama kali menerima request dan dia tidak tahu isi dari src folder, maka kita perlu menambahkan volume untuk mengekspose php service ke server service.
|
1 2 |
volumes: - ./src:/var/www/html |
Selanjutnya, kita akan menyalakan service yang berada di docker-compose, namun tidak semuanya, hanya service server, php, dan mysql.
|
1 |
docker-compose up -d server php mysql |
Setelah selesai proses deployment, buka browser http://localhost:8000, aplikasi laravel berhasil dijalankan dari docker.
Bagaimana jika banyak service yang harus dijalankan? Perintah docker-compose up -d service1 service2 service3 tidak efektif tentunya. Terdapat alternatif lain untuk menjalankan perintah ini, ialah dengan menambahkan dependency di docker-compose.yaml, misalnya pada service server, tambahkan depends_on php dan mysql.
|
1 2 3 |
depends_on: - php - mysql |
Terdapat satu trik lagi supaya docker-compose me rebuild image dengan yang terbaru, kita bisa menambahkan option –build ketika menjalankan docker run:
|
1 |
docker-compose up -d --build server |
Kita bisa langsung mengubah2 kode di folder src, perubahannya akan langsung terlihat ketika kita menjalankan laravel.
7. Menambahkan Utility Container
Utility container yang akan kita tambahkan adalah artisan. Artisan membutuhkan php untuk operasionalnya, karena itu kita akan menggunakan php.dockerfile untuk ditaruh di docker-compose.yaml. Di docker-compose.yaml untuk artisan juga kita akan menambahkan entrypoint untuk override php.dockerfile dan mengeksekusi perintah php artisan.
Utility container yang kita buat lagi adalah npm, sehingga docker-compose.yaml menjadi seperti ini:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 |
version: "3.8" services: server: image: 'nginx:stable-alpine' ports: - '8000:80' volumes: - ./src:/var/www/html - ./nginx/nginx.conf:/etc/nginx/conf.d/default.conf:ro depends_on: - php - mysql php: build: context: ./dockerfiles dockerfile: php.dockerfile volumes: - ./src:/var/www/html:delegated mysql: image: mysql:5.7 env_file: - ./env/mysql.env composer: build: context: ./dockerfiles dockerfile: composer.dockerfile volumes: - ./src:/var/www/html artisan: build: context: ./dockerfiles dockerfile: php.dockerfile volumes: - ./src:/var/www/html entrypoint: ["php", "/var/www/html/artisan"] npm: image: node:14 working_dir: /var/www/html entrypoint: ["npm"] volumes: - ./src:/var/www/html |
Selanjutnya kita akan coba untuk menjalankan docker-compose run artisan dari terminal:
|
1 |
docker-compose run --rm artisan migrate |
Perintah ini akan membuat tabel-tabel di dalam database.
Kita telah berhasil membuat aplikasi laravel dengan docker. Namun ada beberapa catatan khususnya tentang bind mount/volumes. Volumes ok jika dilakukan di development environment, namun tidak disarankan jika kita ingin mendeploy container. Sebaiknya seluruh source code dan configurasi sudah ada di dalam container, tidak perlu membuat bind mount dari laptop kita.
Alternatifnya, kita bisa membuat file nginx.dockerfile di folder dockerfiles.
|
1 2 3 4 5 6 7 8 9 10 11 |
FROM nginx:stable-alpine WORKDIR /etc/nginx/conf.d COPY nginx/nginx.conf . RUN mv nginx.conf default.conf WORKDIR /var/www/html COPY src . |
php.dockerfile juga perlu disesuaikan untuk mengcopy isi folder src ke working directory container dan tambahkan perintah untuk memberikan permission untuk melakukan operasi write pada folder /var/www/html:
|
1 2 3 4 5 6 7 8 9 |
FROM php:8.1.5-fpm-alpine3.15 WORKDIR /var/www/html COPY src . RUN docker-php-ext-install pdo pdo_mysql RUN chown -R www-data:www-data /var/www/html |
Sehingga kita tidak perlu menggunakan bind mount di service nginx dan php pada docker-compose.yaml
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 |
version: "3.8" services: server: # image: 'nginx:stable-alpine' build: context: . dockerfile: dockerfiles/nginx.dockerfile ports: - '8000:80' # volumes: # - ./src:/var/www/html # - ./nginx/nginx.conf:/etc/nginx/conf.d/default.conf:ro depends_on: - php - mysql php: build: context: . dockerfile: dockerfiles/php.dockerfile # volumes: # - ./src:/var/www/html:delegated mysql: image: mysql:5.7 env_file: - ./env/mysql.env composer: build: context: ./dockerfiles dockerfile: composer.dockerfile volumes: - ./src:/var/www/html artisan: build: context: . dockerfile: dockerfiles/php.dockerfile volumes: - ./src:/var/www/html entrypoint: ["php", "/var/www/html/artisan"] npm: image: node:14 working_dir: /var/www/html entrypoint: ["npm"] volumes: - ./src:/var/www/html |
Jalankan lagi perintah ini di terminal:
|
1 |
docker-compose up -d --build server |
Maka aplikasi laravel siap untuk di deploy di production.