docker로 Laravel 개발 환경 구축 4편 (Laravel 프로젝트 생성)

이제 docker로 Laravel 개발 환경을 구축하는 방법의 거의 마지막 포스트다.

지금까지는 라라벨^Laravel을 설치하기 위한 준비 과정이었는데, 이번에는 드디어 라라벨을 설치해 보겠다.

이전 포스트

docker로 Laravel 개발 환경 구축 3편 (MariaDB 컨테이너 생성)

Docker Laravel 개발 환경 구축 3편에서는 MariaDB 컨테이너를 생성합니다. 데이터 영속화를 위한 설정과 .env 파일에 데이터베이스 환경 변수를 추가합니다. my.cnf 설정과 함께 DB 접속을 확인하는 방법까지 정리합니다.

Laravel 설치

docker-compose exec app bash

ubuntu로 docker-compose.yml 파일이 있는 디렉터리에서 이 명령어를 실행해서 컨테이너 안으로 들어간다.

composer create-project --prefer-dist "laravel/laravel" .

이 명령어를 입력하면 드디어 Laravel을 설치하기 시작하지만, 가장 최신 버전을 설치하게 되기 때문에 특정 버전을 설치하고 싶다면 아래의 내용을 참고하자.

참고로 여기서는 Laravel 11을 설치했다.

• --prefer-dist 옵션은 Composer가 가능한 경우 압축 파일 대신 zip 아카이브를 사용하여 패키지를 설치한다. 더 빠른 설치를 위해 권장된다.
• 혹시 Laravel의 특정 버전을 설치하고 싶다면 "laravel/laravel:^11.4"와 같은 식으로 버전을 입력하면 된다.
• 마지막의 .은 빌드가 실행되는 위치를 설정하는 것으로 .은 현재 위치라는 뜻이다. (src/에 설치된다.)

php artisan -v

설치가 완료되면 위의 명령어로 설치된 Laravel의 버전을 확인한다.

exit

확인이 끝나면 컨테이너 밖으로 나오자.

Laravel 첫 페이지에서 에러가 발생할 경우

이제 http://localhost 에 접속하면 Laravel의 첫 페이지가 나와야 하는데, 이렇게 에러가 발생하는 경우가 있다.

ls -l

이전(php 컨테이너를 만들 때)에 했던 설정으로 src 디렉터리의 소유자가 본인으로 되어 있지만,

ls -l src/

src 디렉터리의 내부를 살펴보면, 설치된 Laravel의 모든 디렉터리와 파일은 또다시 소유자가 root로 설정되어 있다.

sudo chown -R 소유자:그룹 src/

다시 한번 위의 명령어를 실행한다.

'소유자'와 '그룹'에 본인의 계정을 넣는다.

sudo chown -R 소유자:www-data src/storage/ src/bootstrap/cache/

그리고 이 명령어를 입력한 뒤에 패스워드를 입력한다. ('소유그룹'에 www-data를 넣는다.)

이 명령은 src/storage/와 src/bootstrap/cache/ 디렉터리, 그리고 그 하위 항목의 소유그룹을 www-data로 설정한다.

chmod -R 775 src/storage/ src/bootstrap/cache/

그런 다음 이 명령으로 디렉터리 권한을 설정한다.

ls -l src/storage/ src/bootstrap/cache/

설정이 잘 적용되었는지 확인한다.

그러고 나서 다시 http://localhost에 접속하면 Laravel의 첫 페이지가 정상적으로 표시될 것이다.

다음 포스트

Makefile로 복잡한 도커 명령어들을 단순화하는 방법

복잡하고 반복적인 docker 명령어를 효율적으로 관리하기 위해 Makefile을 활용하는 방법을 소개합니다. docker-compose up -d와 같은 긴 명령어를 make up처럼 단순화하는 Makefile 설정 예시를 제공합니다.

이 글이 도움이 됐거나 유익했다면 스크롤을 조금만 더 내려서 댓글을 남겨주세요. (비로그인도 가능합니다!)
응원이나 피드백이 담긴 댓글은 제가 계속 블로그를 해나갈 수 있는 원동력이 됩니다. 😊

지인에게 보여주고 싶은 글이었다면 URL을 복사해서 메신저나 소셜 미디어에 공유해 주세요.