ServBay에서 FacturaScripts 프로젝트 생성 및 실행하기
FacturaScripts는 중소기업과 프리랜서를 위한 강력하고 유연한 오픈소스 ERP(기업 자원 관리) 및 CRM(고객 관계 관리) 솔루션입니다. ServBay가 제공하는 간편한 로컬 웹 개발 환경을 활용하면 복잡한 설정 없이 macOS에서 FacturaScripts 프로젝트를 생성, 테스트, 실행할 수 있습니다.
이 가이드는 ServBay로 FacturaScripts를 로컬에 설치 및 구성하는 전체 과정을 단계별로 안내합니다.
FacturaScripts 개요
FacturaScripts는 PHP와 Bootstrap 프레임워크 기반으로 개발된 오픈소스 ERP 및 CRM 소프트웨어입니다. 이 소프트웨어는 기업이 다음과 같은 핵심 업무 프로세스를 효율적으로 관리할 수 있도록 고안되었습니다:
- 송장 발행 및 관리
- 회계 처리
- 재고 관리
- 고객 및 공급업체 관리
- 프로젝트 관리
- 그 외 다양한 모듈 및 플러그인을 통한 추가 기능 등...
활발하게 유지·관리되는 오픈소스 프로젝트로, FacturaScripts는 강력한 커뮤니티 지원을 자랑하며, 플러그인을 통해 기능 확장과 커스터마이즈가 용이하여 다양한 비즈니스 요구에 대응할 수 있습니다.
FacturaScripts의 주요 특징 및 장점
- 오픈소스 및 무료: 고가의 라이선스 비용을 지불하지 않고 자유롭게 사용·수정·배포 가능
- 풍부한 기능: 중소기업의 일상 운영에 필요한 대부분의 핵심 기능 제공, 올인원 솔루션
- 사용자 친화적: 직관적인 UI 디자인과 완만한 학습 곡선
- 높은 확장성: 다양한 플러그인 마켓과 개방형 API 지원, 손쉬운 기능 추가 및 외부 서비스 연동
- 크로스플랫폼 접근: 웹 기반이므로 최신 브라우저 지원 기기 어디서나 사용 가능
- 활발한 커뮤니티: 글로벌 개발자 커뮤니티의 지원과 해결책 제공
- 다국어 지원: 여러 언어 인터페이스 제공, 다양한 국가에서 사용 편리
ServBay에서 FacturaScripts를 실행할 때의 강점
ServBay는 개발자를 위해 설계된 로컬 웹 개발 환경으로, PHP 애플리케이션(예: FacturaScripts) 실행에 최적화된 플랫폼입니다. Apache/Nginx 웹 서버, 다양한 PHP 버전, MySQL/MariaDB/PostgreSQL 데이터베이스, Redis 등 자주 쓰는 개발 툴을 통합 제공하며, 직관적 GUI로 모든 요소를 편하게 관리할 수 있습니다.
ServBay에서 FacturaScripts를 실행하면 얻을 수 있는 주요 장점 및 절차는 다음과 같습니다:
- 통합 환경: FacturaScripts 구동에 필요한 핵심 요소(웹 서버, PHP, 데이터베이스 등)를 미리 설치 및 셋업, 별도 소프트웨어 수동 설정 필요 없음
- 버전 관리: FacturaScripts 버전에 따라 적합한 PHP 버전 간 손쉬운 전환 및 호환성 테스트 가능
- 데이터베이스 관리: phpMyAdmin 또는 Adminer 등 내장 툴로 데이터베이스/사용자 쉽게 관리
- 간편한 사이트 설정: GUI를 통해 로컬 사이트, 도메인, 루트 디렉터리, 웹 서버 및 PHP 버전 빠르게 설정
- Hosts 자동 관리: 로컬 도메인(예:
facturascripts.servbay.demo)을 Hosts 파일에 자동 등록, 수동 편집 불필요 - SSL 지원: 내장 User CA 또는 공용 ACME 서비스로 SSL/HTTPS 환경 간편 구축—실제 운영 환경 시뮬레이션 가능
ServBay에서 FacturaScripts를 실행하는 요약 단계는 다음과 같습니다:
- FacturaScripts 소스 다운로드
- ServBay의 웹사이트 루트 디렉터리에 프로젝트 폴더 생성
- FacturaScripts용 MySQL 데이터베이스 및 사용자 생성
- ServBay에서 웹 서버(Apache 또는 Nginx)가 프로젝트 경로를 바라보도록 설정
- 필요한 PHP 확장 모듈 확인 및 활성화
- 브라우저에서 로컬 도메인 접근 및 FacturaScripts 온라인 설치 마법사 진행
사전 준비 사항
시작 전, 아래 조건을 반드시 충족해 주세요:
- macOS에 ServBay 설치 및 기동을 완료했을 것. ServBay 공식 웹사이트에서 최신 버전 다운로드 가능
- ServBay 핵심 패키지(선택한 웹 서버 Apache/Nginx, PHP 버전, MySQL 또는 MariaDB 등)가 실행 중일 것
- 기본적인 웹 개발 및 데이터베이스 개념을 알고 있을 것
FacturaScripts 프로젝트 생성(Zip 패키지 다운로드 방식)
로컬 환경에서 FacturaScripts를 설치하는 가장 널리 쓰이고 손쉬운 방법입니다.
FacturaScripts 다운로드
- FacturaScripts 공식 웹사이트의 다운로드 페이지( https://facturascripts.com/descargar )로 이동
- 최신 안정화 버전의
.zip패키지 다운로드
프로젝트 디렉터리 생성
- Finder에서 ServBay가 웹사이트 파일을 저장하는 루트 디렉터리로 이동. 기본 권장 경로는
/Applications/ServBay/www/ - 이 경로에 새 폴더 생성(예:
facturascripts_project) - 전체 경로 예시:
/Applications/ServBay/www/facturascripts_project
- Finder에서 ServBay가 웹사이트 파일을 저장하는 루트 디렉터리로 이동. 기본 권장 경로는
압축 해제 및 옮기기
- 다운로드한 FacturaScripts
.zip파일을 찾아 더블 클릭하여 압축 해제 - 생성된 모든 파일/폴더(예:
index.php,Core,Dinamic,Plugins등)를/Applications/ServBay/www/facturascripts_project에 복사 또는 이동
- 다운로드한 FacturaScripts
초기 세팅(MySQL 데이터베이스 등)
FacturaScripts는 모든 비즈니스 데이터·사용자·설정 관리를 위해 별도 데이터베이스가 필요합니다. ServBay가 관리하는 MySQL 또는 MariaDB 패키지를 사용해서 데이터베이스를 생성합니다.
데이터베이스 패키지 실행 확인
- ServBay 앱 실행
- 왼쪽 메뉴에서 "패키지" - "MySQL" 또는 "MariaDB" 선택(사용하고자 하는 데이터베이스 종류 선택)
- 선택한 데이터베이스 패키지가 실행 중인지 확인. 만약 실행 중이 아니라면 스위치 버튼을 눌러 기동
데이터베이스 및 사용자 생성
- ServBay 내장 DB 관리 툴(phpMyAdmin, 보통 MySQL/MariaDB 패키지와 함께 제공) 또는 ServBay가 제공하는 터미널로 생성 가능. 초보자에게는 phpMyAdmin 사용이 더 직관적임
- phpMyAdmin 사용(권장):
- ServBay에서 "데이터베이스" 부분에서 사용 중인 데이터베이스 옆 phpMyAdmin 아이콘 클릭 → 브라우저로 phpMyAdmin 접속
- phpMyAdmin 로그인: 기본적으로
root계정과 ServBay 설치 중 지정한 root 비밀번호 사용 (비밀번호 분실 시 ServBay에서 리셋 기능 제공) - 로그인 후 상단 "데이터베이스" 탭 클릭
- "데이터베이스 생성"란에 데이터베이스 이름 입력(예:
facturascripts_servbay_db권장) - 문자셋 및 콜레이션은
utf8mb4_general_ci또는utf8mb4_unicode_ci추천 - "생성" 버튼 클릭
- DB 사용자 생성(강력히 추천): 보안을 위해 root 대신 별도의 전용 계정 추천
- 상단 "사용자 계정" 탭 → "사용자 추가"
- 사용자명 입력(예:
facturascripts_servbay_user), 호스트는localhost또는127.0.0.1선택 - 강력한 암호 입력/생성 후 반드시 별도 보관
- "사용자와 동일한 이름의 데이터베이스 생성 후 모든 권한 부여" 체크하면 편리, 아니면 "특정 DB 권한 수동 부여"에서 방금 만든 DB(
facturascripts_servbay_db)에ALL PRIVILEGES체크 - 하단 "실행" 버튼 클릭
데이터베이스 연결 정보 기록: FacturaScripts 설치 중 아래 정보를 입력해야 하므로 메모해둘 것
- 데이터베이스 이름 (예:
facturascripts_servbay_db) - 데이터베이스 계정명 (예:
facturascripts_servbay_user) - 계정 비밀번호
- DB 호스트(일반적으로
localhost또는127.0.0.1) - DB 포트(MySQL/MariaDB는 기본
3306, 실제 인스턴스 포트는 ServBay에서 확인 가능)
- 데이터베이스 이름 (예:
웹 서버(아파치/엔진엑스) 설정
이제 ServBay가 웹 서버(아파치 또는 엔진엑스)를 통해 FacturaScripts 프로젝트 파일에 접근할 수 있도록 알려줘야 합니다. 둘 다 완벽 지원합니다.
웹 서버 패키지 기동 확인
- ServBay의 "패키지" 메뉴에서 원하는 웹 서버(Apache 혹은 Nginx)가 실행 중인지 확인
웹사이트 추가
- 왼쪽 메뉴에서 "사이트" 선택
- 오른쪽 상단 "+" 버튼 클릭하여 웹사이트 추가
- 팝업 창에 필수 정보 입력:
- 이름: 예:
FacturaScripts Demo Site - 도메인: 개발자 권장 패턴인
.servbay.demo를 사용해facturascripts.servbay.demo등 입력 - 웹사이트 유형:
PHP선택 - 루트 디렉터리: "찾아보기/선택" 클릭 후
/Applications/ServBay/www/facturascripts_project지정 (일부 웹 프레임워크는 하위public/web폴더 필요, FacturaScripts는 루트 경로 지정即可) - PHP 버전: FacturaScripts 공식 요구사항에 맞는 PHP 8.1/8.2 등 최신 버전 선택
- 기타 옵션: 기본값 권장, ServBay는 SSL/HTTPS(ServBay User CA, ACME), CORS 등의 고급 설정도 지원
- 이름: 예:
설정 저장 및 Hosts 업데이트
- 저장 후, ServBay가 자동으로 웹 서버 가상 호스트 구성 및 Hosts 파일에 해당 도메인(
facturascripts.servbay.demo) →127.0.0.1등록 (관리자 권한이 필요할 수 있음) - 이제 브라우저에서 해당 도메인으로 바로 접근 가능
- 저장 후, ServBay가 자동으로 웹 서버 가상 호스트 구성 및 Hosts 파일에 해당 도메인(
PHP 확장 모듈 점검 및 활성화
- FacturaScripts가 정상 동작하려면
pdo_mysql,gd,intl,zip,xml,curl등 필수 PHP 확장 모듈이 필요합니다. ServBay는 주요 확장 대부분을 기본 활성화하지만, 설치나 실행 과정에서 특정 확장 모듈이 누락되었다고 나오면 수동 활성화 필요 - 확장 모듈 활성화 방법:
- 왼쪽 "언어" - "PHP" 선택
- 현재 FacturaScripts용으로 할당한 PHP 버전(예: PHP 8.2)을 선택
- 상단 "확장" 탭 클릭
- 필요한 확장이 비활성화 되어 있으면 체크 박스 선택 후 "적용" 또는 "저장" 클릭 (일부 확장 모듈은 PHP 서비스 재시작 필요, 좌측에서 해당 PHP 버전 우측 재시작 버튼 클릭)
- FacturaScripts가 정상 동작하려면
ServBay 사이트 구성 인터페이스 예시
사이트 접속 및 FacturaScripts 설치 마법사 실행
이제 ServBay 환경이 준비되었으니 실제로 FacturaScripts 설치 마법사를 실행해보세요.
브라우저 열기: 크롬, 파이어폭스, 사파리 등 선호하는 웹 브라우저 실행
주소 입력: 주소창에 사전에 등록한 로컬 도메인(
http://facturascripts.servbay.demo) 입력. 만약 ServBay에서 SSL 인증서를 적용했다면https://facturascripts.servbay.demo로 접속 가능. Enter 누르기FacturaScripts 설치 마법사
- ServBay 사이트 설정, Hosts, 웹 서버/PHP 서비스가 정상이라면 FacturaScripts 환영 화면 또는 설치 마법사 자동 안내 화면이 나옴
- 언어 선택: 원하는 관리자 UI 언어 선택
- 시스템 환경 점검: PHP 버전, 확장 모듈, 디렉터리 쓰기 권한 등 최소 요구조건 자동 점검(모두 정상/초록 불이어야 함). 만약 오류/경고시 ServBay 설정 또는 파일 디렉터리 권한을 점검 및 조정
- 데이터베이스 연결: 앞서 생성한 연결 정보 입력
- DB 종류: MySQL
- 호스트:
localhost혹은127.0.0.1 - 포트:
3306(실제 포트는 ServBay에서 확인) - DB 이름, 계정, 비밀번호: 앞서 만든 값 입력,
- 테이블 접두어: 기본값
fs_유지 또는 필요시 변경
- 관리자 계정 생성: FacturaScripts 백오피스용 관리자 계정(아이디, 비밀번호, 이메일) 생성(정보 꼭 보관)
- 설치 진행: 확인 후 설치 버튼 클릭. DB 연결, 테이블 자동 생성, 설정 파일 자동 저장
설치 완료 후
- 설치가 완료되면 보안을 위해 루트에 있는
install디렉토리 삭제 안내 받을 수도 있음. 지시에 따라 삭제 - 이제
http://facturascripts.servbay.demo(또는 HTTPS)에서 로그인 가능. 앞서 생성한 관리자 계정으로 로그인, 본격적으로 FacturaScripts를 경험해보세요!
- 설치가 완료되면 보안을 위해 루트에 있는
자주 묻는 질문(FAQ)
- Q: FacturaScripts 설치 중 PHP 확장 누락 메시지가 나와요.
- A: ServBay 앱에서 왼쪽 "언어" – "PHP"로 이동, 해당 사이트에 할당된 PHP 버전 선택 후 "확장" 탭에서 부족한 확장(예:
opcache) 체크 → "적용" 누르고 PHP 서비스 재시작.
- A: ServBay 앱에서 왼쪽 "언어" – "PHP"로 이동, 해당 사이트에 할당된 PHP 버전 선택 후 "확장" 탭에서 부족한 확장(예:
- Q:
facturascripts.servbay.demo접속시 "Forbidden" 에러 또는 빈 페이지가 나와요.- A: 1) 웹 서버(Apache/Nginx), PHP 서비스가 기동 중인지, 2) 사이트 설정의 루트 디렉토리가
/Applications/ServBay/www/facturascripts_project로 정상 지정됐는지 점검. 빈 페이지일 경우 PHP 오류일 수 있으므로 ServBay의 웹 서버나 PHP 에러 로그 확인. "Forbidden"의 경우 파일/디렉터리 권한 문제 가능성 높으므로, 해당 폴더 및 하위 디렉터리에 웹 서버 사용자 권한이 있는지 확인.
- A: 1) 웹 서버(Apache/Nginx), PHP 서비스가 기동 중인지, 2) 사이트 설정의 루트 디렉토리가
- Q: FacturaScripts DB 연결이 계속 실패해요.
- A: ServBay의 MySQL/MariaDB가 정상 실행 및 포트(
3306)가 맞는지 확인. FacturaScripts 설치 마법사에서 입력하는 모든 DB 정보(호스트, 포트, DB이름, 사용자명, 비밀번호)가 ServBay에서 만든 값과 일치하는지 재확인.
- A: ServBay의 MySQL/MariaDB가 정상 실행 및 포트(
요약
ServBay의 강력한 로컬 개발 환경 덕분에 macOS에서 FacturaScripts를 아주 쉽고 빠르게 설치/운영할 수 있습니다. ServBay는 웹 서버, PHP, 데이터베이스 등 모든 필수 의존성을 통합 제공하고, GUI 기반 관리로 환경 구축을 대폭 단순화시켜줍니다. 본 가이드를 따라하면 FacturaScripts 기반의 개발/테스트 환경을 즉시 구축할 수 있어, 비즈니스 핵심 기능의 빠른 탐색에 전념할 수 있습니다. ServBay의 유연성과 편의성은 macOS 개발 생산성을 크게 향상시켜줄 것입니다.