라이믹스/매뉴얼/설치 환경

개요

라이믹스를 설치하고 운영하기 위해 필요한 시스템 요구사항을 정리한 문서입니다. 기본적으로 웹 서버(예: Apache, Nginx) 같은 필수 요소는 당연히 있어야 하니 여기선 생략했습니다.

퍼미션

라이믹스 설치 루트 폴더 안의 files 폴더 퍼미션은 707 또는 777로 설정해야 합니다. 설치 경로에 쓰기 권한이 있으면 설치 중 자동으로 files 폴더가 생성되지만, 권한이 없으면 직접 폴더를 만들고 퍼미션을 조정해야 합니다.

PHP

버전

라이믹스 설치에는 PHP 7.4 이상이 필요합니다.

PHP 7.2 이상에서의 문제

PHP 7.2 이상에서는 일부 서드파티 모듈 때문에 BaseObject 오류가 발생할 수 있습니다. 기존에 사용되던 Object 클래스가 PHP 7.2부터 지원되지 않아 'Fatal error'(HTTP 500 오류)가 뜨는 경우가 생깁니다. 이 문제는 XE에서도 공통적으로 나타나는 현상으로, XE 공식 공지에 따르면 Object를 BaseObject로 바꿔야 해결됩니다.손이 좀 가는 작업 에디터에서 찾아바꾸기 기능을 활용하면 편리합니다.

리눅스 환경이라면 아래 명령어로 쉽게 일괄 변경 가능합니다.

root@gaon:/var/www/html/# find ./ -name "*.php" -exec sed -i 's/return\snew\sObject/return new BaseObject/g' {} \;
root@gaon:/var/www/html/# find ./ -name "*.php" -exec sed -i 's/extends\sObject/extends BaseObject/g' {} \;

다만, 타임라인 모듈처럼 예외적인 경우는 명령어가 적용되지 않을 수 있으니, 이런 경우엔 직접 수정해야 합니다. 타임라인 모듈이라면 ./modules/timeline/timeline.admin.model.php 파일의 44번째 줄에서 Object를 BaseObject로 바꾸면 됩니다.

필수 PHP 모듈

라이믹스 설치에 반드시 필요한 PHP 모듈은 다음과 같습니다:

• curl
• gd
• iconv 또는 mbstring
• json
• openssl
• PDO_MySQL
• SimpleXML
• Zend OPCache

권장 PHP 모듈

설치는 필수가 아니지만 성능 개선이나 특정 기능에 유용한 모듈들입니다:

• apcu (캐시로 성능 향상)
• exif (이미지 자동 회전)
• fileinfo (첨부파일 보안 검사)
• intl (한글 도메인 처리 효율성)
• zip (향후 필수로 바뀔 가능성 있음)
• mod_rewrite (Apache에서 짧은 주소 사용 시, 선택 사항)

php.ini 설정

• upload_max_filesize < post_max_size < memory_limit 순으로 설정값이 커야 합니다.
• session.auto_start는 반드시 꺼져 있어야 합니다:

session.auto_start = off

• memory_limit은 최소 128M 이상으로 설정되어 있어야 합니다.

MySQL/MariaDB

MySQL은 5.7 이상 버전을 사용해야 하며, 개발진은 MariaDB 10.1 이상을 권장합니다.