사전 요구사항

안녕하세요! Laravel과 JinyERP로 개발하기 전에 먼저 컴퓨터에 필요한 프로그램들을 설치해야 합니다. 마치 요리를 하기 전에 재료를 준비하는 것과 같다고 생각하시면 됩니다.

💡 강의 노트: 개발 환경 설정은 처음에만 복잡해 보이지만, 한 번 제대로 설정해두면 계속 사용할 수 있어요. 차근차근 따라하시면 됩니다!

🔧 필수 소프트웨어

이제 필요한 프로그램들을 하나씩 설치해보겠습니다.

PHP 8.4+ 설치

PHP는 Laravel의 심장과 같은 존재입니다. Laravel은 PHP로 만들어진 프레임워크이기 때문에 반드시 PHP가 설치되어 있어야 합니다. 최신 버전인 8.4를 설치하는 이유는 성능이 더 좋고 보안도 강화되었기 때문입니다.

🎯 실습 팁: 아래 명령어를 터미널(명령 프롬프트)에서 실행해주세요. macOS와 Windows/Linux에 따라 방법이 다릅니다.

macOS (Homebrew)

# PHP 8.4 설치
brew install php@8.4

# PHP 버전 확인
php --version

# PHP 확장 모듈 확인
php -m | grep -E "(pdo|mbstring|openssl|tokenizer|xml|curl)"

Ubuntu/Debian

# PHP 8.4 저장소 추가
sudo add-apt-repository ppa:ondrej/php
sudo apt update

# PHP 8.4 및 필수 확장 설치
sudo apt install php8.4-cli php8.4-fpm php8.4-mysql php8.4-pgsql php8.4-xml php8.4-curl php8.4-zip php8.4-mbstring php8.4-bcmath php8.4-tokenizer php8.4-sqlite3 php8.4-gd php8.4-intl php8.4-redis

# PHP 버전 확인
php --version

📁 PHP 관련 설정 파일 경로:

  • macOS 설정: /usr/local/etc/php/8.4/php.ini
  • Ubuntu 설정: /etc/php/8.4/cli/php.ini
  • PHP-FPM 설정: /etc/php/8.4/fpm/php.ini

Composer 2.5+ 설치

# Composer 설치 (전역)
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

# 또는 Homebrew (macOS)
brew install composer

# 버전 확인
composer --version

# 최신 버전으로 업데이트
composer self-update

📁 Composer 관련 파일 경로:

  • 전역 설정: ~/.composer/config.json
  • 캐시 디렉토리: ~/.composer/cache/
  • 전역 패키지: ~/.composer/vendor/

Node.js 20.x LTS 설치

macOS

# Node.js 20.x LTS 설치
brew install node@20

# 또는 nvm 사용
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20

# 버전 확인
node --version
npm --version

Ubuntu/Debian

# Node.js 20.x 저장소 추가
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

# Node.js 설치
sudo apt install nodejs

# 버전 확인
node --version
npm --version

# npm 업데이트
npm install -g npm@latest

📁 Node.js 관련 파일 경로:

  • Node.js 설치: /usr/local/bin/node
  • npm 캐시: ~/.npm/
  • 전역 패키지: /usr/local/lib/node_modules/

Git 최신 버전 설치

# macOS
brew install git

# Ubuntu/Debian
sudo apt install git

# 버전 확인
git --version

# Git 전역 설정
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

📁 Git 관련 설정 파일:

  • 전역 설정: ~/.gitconfig
  • 프로젝트 설정: ./.git/config
  • 전역 ignore: ~/.gitignore_global

🗄️ 데이터베이스 시스템

PostgreSQL 15+ (권장)

macOS

# PostgreSQL 설치
brew install postgresql@15

# 서비스 시작
brew services start postgresql@15

# PostgreSQL 접속 테스트
psql postgres

Ubuntu/Debian

# PostgreSQL 설치
sudo apt update
sudo apt install postgresql-15 postgresql-contrib-15

# 서비스 시작 및 활성화
sudo systemctl start postgresql
sudo systemctl enable postgresql

# PostgreSQL 접속 테스트
sudo -u postgres psql

📁 PostgreSQL 관련 파일 경로:

  • 메인 설정: /usr/local/var/postgres/postgresql.conf (macOS)
  • Ubuntu 설정: /etc/postgresql/15/main/postgresql.conf
  • 데이터 디렉토리: /usr/local/var/postgres/ (macOS)
  • 로그 파일: /usr/local/var/log/postgres.log
  • 접속 설정: /usr/local/var/postgres/pg_hba.conf

MySQL 8.0+ (대안)

macOS

# MySQL 설치
brew install mysql@8.0

# 서비스 시작
brew services start mysql@8.0

# 보안 설정
mysql_secure_installation

Ubuntu/Debian

# MySQL 설치
sudo apt update
sudo apt install mysql-server-8.0

# 서비스 시작
sudo systemctl start mysql
sudo systemctl enable mysql

# 보안 설정
sudo mysql_secure_installation

📁 MySQL 관련 파일 경로:

  • 메인 설정: /usr/local/etc/my.cnf (macOS)
  • Ubuntu 설정: /etc/mysql/mysql.conf.d/mysqld.cnf
  • 데이터 디렉토리: /usr/local/var/mysql/
  • 로그 파일: /usr/local/var/mysql/*.err

Redis (선택사항)

# macOS
brew install redis
brew services start redis

# Ubuntu/Debian
sudo apt install redis-server
sudo systemctl start redis-server
sudo systemctl enable redis-server

# Redis 연결 테스트
redis-cli ping

📁 Redis 관련 파일 경로:

  • 설정 파일: /usr/local/etc/redis.conf (macOS)
  • Ubuntu 설정: /etc/redis/redis.conf
  • 로그 파일: /var/log/redis/redis-server.log

🛠️ 권장 개발 도구

PHP IDE

PHPStorm (유료, 추천)

  • 다운로드: JetBrains PHPStorm
  • Laravel 플러그인 포함
  • 데이터베이스 도구 통합

VS Code (무료)

# VS Code 설치 (macOS)
brew install --cask visual-studio-code

# 필수 확장 설치
code --install-extension bmewburn.vscode-intelephense-client
code --install-extension bradlc.vscode-tailwindcss
code --install-extension onecentlin.laravel-blade
code --install-extension ms-vscode.vscode-json

VS Code 권장 확장:

  • PHP Intelephense - PHP 언어 서버
  • Laravel Blade Syntax - Blade 템플릿 지원
  • Tailwind CSS IntelliSense - Tailwind CSS 자동완성
  • GitLens - Git 기능 확장

데이터베이스 도구

TablePlus (macOS/Windows, 유료)

  • 다운로드: TablePlus
  • PostgreSQL, MySQL 모두 지원
  • 직관적인 GUI

phpMyAdmin (MySQL, 무료)

# Homebrew로 설치 (macOS)
brew install phpmyadmin

# Ubuntu에서 설치
sudo apt install phpmyadmin

Sequel Pro (macOS, 무료)

API 테스트 도구

Postman

  • 다운로드: Postman
  • API 개발 및 테스트

Insomnia

  • 다운로드: Insomnia
  • 가벼운 REST 클라이언트

✅ 설치 확인 체크리스트

필수 소프트웨어

# PHP 8.4+ 확인
php --version
# PHP 8.4.x (cli) 출력 확인

# Composer 2.5+ 확인
composer --version
# Composer version 2.5.x 출력 확인

# Node.js 20.x 확인
node --version
# v20.x.x 출력 확인

# npm 확인
npm --version
# 10.x.x 출력 확인

# Git 확인
git --version
# git version 2.x.x 출력 확인

데이터베이스 연결 확인

# PostgreSQL 연결 테스트
psql -h localhost -U postgres -c "SELECT version();"

# MySQL 연결 테스트
mysql -u root -p -e "SELECT VERSION();"

# Redis 연결 테스트 (선택사항)
redis-cli ping
# PONG 응답 확인

개발 도구 확인

  • PHP IDE 설치 (PHPStorm 또는 VS Code)
  • 데이터베이스 GUI 도구 설치
  • API 테스트 도구 설치

🔗 다음 단계

사전 요구사항 설치가 완료되었으면:

  1. Laravel 프로젝트 설치 → 02.laravel-install.md
  2. 데이터베이스 설정 → 03.database.md
  3. GitHub 배포 준비 → 04.github-deploy.md

❓ 문제 해결

PHP 설치 이슈

  • macOS PHP 충돌: brew unlink php 후 brew link php@8.4
  • Ubuntu 확장 누락: sudo apt install php8.4-{extension}
  • 권한 문제: sudo 없이 명령어 실행 시도

Composer 이슈

  • 느린 다운로드: composer config --global repo.packagist composer https://packagist.org
  • 메모리 부족: php -d memory_limit=-1 $(which composer) install

Node.js 버전 관리

  • 여러 버전 사용: nvm 또는 n 패키지 관리자 활용
  • 권한 문제: sudo를 사용하지 말고 사용자 권한으로 설치

이 문서는 Laravel JinyERP 개발을 위한 기본 환경 설정을 다룹니다.