안드로이드 폰에서 Laravel 8 설치하고 설정하는 방법 (Termux 활용)

안녕하세요! 이 글에서는 노트북이나 PC 없이 스마트폰만으로 Laravel 8을 설치하고 개발 환경을 구축하는 방법을 소개해 드리겠습니다.

이 가이드를 최대한 활용하려면 PHP에 대한 기본 지식과 Laravel이 무엇인지 정도는 알고 있는 것이 좋습니다. 하지만 몰라도 걱정하지 마세요. 기본 개념부터 차근차근 설명해 드릴 테니 누구나 따라올 수 있습니다.

Laravel이란?

Laravel은 표현력 있고 우아한 문법을 자랑하는 웹 애플리케이션 프레임워크입니다. PHP 기반으로 만들어졌기 때문에 본질적으로는 PHP이지만, 훨씬 더 쉽고 편리하게 작업할 수 있도록 도와줍니다.

또한 인증(Authentication) 같은 다양한 기능을 위한 패키지가 풍부하게 제공되어, 개발자가 일일이 직접 작성할 필요가 없습니다. Laravel의 기능이 궁금하다면 공식 사이트 laravel.com을 방문해 보세요.

이 튜토리얼을 작성하게 된 이유

노트북이나 PC가 없어도 프로그래밍에 관심 있는 사람들이 스마트폰으로 직접 무언가를 만들 수 있기를 바라는 마음에서 이 튜토리얼을 준비했습니다.

이전에 freeCodeCamp에 올린 글을 통해 많은 분들이 기술이 실제로 어떻게 동작하는지 배우는 데 큰 관심이 있다는 것을 깨달았고, 그래서 이런 가이드를 더 만들게 되었습니다.

자, 그럼 시작해 보겠습니다. 이 튜토리얼에서는 composer.php를 설치하고 이를 활용해 폰에서 Laravel 8을 세팅하는 방법을 알려드리겠습니다 🔥🔥

저는 Precious Oladele이고, 이번 달이면 19살이 됩니다 🥴 나이지리아 출신이며, 오늘 과정 전체를 안내해 드리겠습니다. 제가 이렇게 잘 안다고 의아해하실 수도 있는데, 사실 저도 노트북이 없어서 폰으로 이것저것 탐험하며 익힌 거랍니다 😎

준비물

이 튜토리얼을 진행하려면 Android 6.0 이상이 설치된 안드로이드 폰이 필요합니다.

환경 설정하기

먼저 Play 스토어에 접속해 Termux를 다운로드합니다:

Termux는 폰에서 사용할 수 있는 Linux 기반 시스템입니다. 일반 Linux를 사용하는 것처럼 간단하며, Kali나 Ubuntu 등 원하는 것이면 뭐든지 설치할 수 있습니다. 다만 이 튜토리얼에서는 모바일 폰에 Laravel 8을 세팅하는 용도로 사용하겠습니다.

Composer 다운로드하기

Composer를 다운로드하기 전에 먼저 Termux 앱을 열고 아래 명령어를 입력합니다:

termux-setup-storage

저장소 접근 권한을 요청하는 메시지가 뜨면 '허용'을 눌러주세요. 완료했다면 https://getcomposer.org/download/ 페이지로 이동합니다.

여기서 모든 코드를 가져와야 합니다. 그 전에 앱에서 PHP를 사용할 수 있도록 PHP를 먼저 설치해야 합니다. Termux에 다음 명령어를 입력하세요:

apt install php

그리고 엔터를 누르면 아래 화면이 나타납니다:

설치가 끝나면 Composer 페이지로 돌아가 코드를 복사합니다. 굳이 이렇게 하는 이유는 Termux가 Linux 기반이기 때문입니다. Windows였다면 composer.exe를 클릭 한 번으로 다운로드할 수 있겠죠.

코드 전체를 복사해서 Termux에 붙여넣은 후 엔터를 누르세요.

Composer 설치가 완료되면 다음과 같은 화면을 볼 수 있습니다:

Laravel 8 설치하기

Laravel 8을 설치하기 전에 composer.phar 파일이 있는지 확인해 보겠습니다. Termux에 아래 명령어를 입력하세요:

ls

엔터를 누르면 현재 사용 가능한 파일 목록이 표시됩니다.

composer.phar 파일과 storage 폴더가 보일 겁니다. storage 폴더는 파일 관리자에 대한 접근 권한을 부여하는 역할을 합니다. 처음 입력했던 termux-setup-storage 명령어 기억하시죠?

이제 Laravel 8을 설치해 보겠습니다. 프로젝트를 생성하는 방식과 전역(global)으로 설치하는 방식 두 가지가 있습니다. 다만 폰에서 전역으로 설치하려면 PATH 설정 등 해야 할 작업이 많아 상당히 번거롭고 헷갈릴 수 있습니다. 그래서 이 가이드에서는 프로젝트를 생성하는 방식을 사용하겠습니다.

Termux에 아래 명령어를 입력하세요:

php composer.phar create-project laravel/laravel myapp

myapp은 단순히 프로젝트 이름일 뿐이니, 원하는 이름으로 자유롭게 변경하셔도 됩니다. 엔터를 누르고 마법이 일어나기를 기다려 보세요 ✨

아래와 같은 화면이 보이면 Laravel 설치가 성공적으로 완료된 것입니다:

정말 쉽죠? 이제 테스트해 보겠습니다. cd myapp 명령어로 myapp 디렉터리에 들어간 후, php artisan serve 명령어로 Laravel 서버를 실행하세요.

짜잔 – 개발이 시작됐습니다 🔥

이제 브라우저에서 https://127.0.0.1:8000 에 접속하면 Laravel이 정상적으로 실행 중인 것을 확인할 수 있습니다:

마지막으로 코딩 중에 Termux 앱이 강제 종료되지 않도록 아래 설정도 꼭 해두세요 😎

마무리

읽어주셔서 감사합니다. 이 튜토리얼을 통해 유익한 정보를 얻으셨기를 바랍니다. 이제 여러분도 안드로이드 폰에 Laravel을 설치하고, 직접 앱을 만들며 개발을 시작할 수 있습니다.

더 많은 콘텐츠가 궁금하다면 제 YouTube 채널인 DevStack을 구독해 주세요 🙏😁