[카테고리:] 개발 레시피

  • 워드프레스 코어 한 벌로 여러 싱글 사이트 세팅하기

    워드프레스는 멀티사이트로 운용할 수 있다. 한 벌의 코어로 여러 사이트를 제작할 수 있다. 이 때 site1.example.com 같은 서브도메인이나 아니면 example.com/site1 처럼 패스로 각 사이트를 생성할 수 있으며, 약간의 수정만 거치면 각 사이트마다 독자적인 도메인 설정도 가능하다.

    그러나 이 방법은 한 코어에 wp-config.php와 플러그인, 테마, 그리고 일부 DB 내용을 공유하게 된다. 즉, 완전히 분리된 사이트를 운용하게 되는 것은 아닌 것이다.

    이 포스트에서는 워드프레스 싱글 사이트를 기반으로 하되 완전히 각자의 영역을 독자적으로 가지는 셋팅법을 적고자 한다. 사실 독자적인 셋팅을 가져가므로 설정에 의해 각 사이트는 싱글 사이트일 수도 있고 멀티사이트가 될 수도 있다. 단, 코어와 코어에 위치한 .htaccess 때문에 싱글사이트 전용, 혹은 멀티사이트 전용으로만 운용 가능하다. 도메인별로 .htaccess 처리가 가능하면 좋겠지만 쉽지 않아 보인다.

    이 방법은 코어를 하나로 절약할 수 있다는 장점이 있다. 워드프레스 코어 API는 워낙 성숙해 있고 변화가 뚜렷하지 않기 때문에 버전간의 차이로 인한 문제가 드문 편이기 때문에 꽤 안심할만하다.

    하지만 내 개인적인으로는 코어 이외에 다른 셋업들은 그냥 하나하나 설치하는 스탠드얼론 방법에 비해 이 방법이 아주 이득이 있는지는 모르겠다. 여러 사이트가 산만하게 늘어지는 것보다는 조금 정리할 수 있다는 여지가 있다는 정도? 그냥 이런 방법이 있고, 이런 응용이 가능하니 기록하는 의미로 포스팅한다.

    도메인 설정

    각 도메인마다 로컬 서버인 127.0.0.1로 매핑해야 한다. 가장 간단한 방법은 /etc/hosts 파일을 편집하는 법이다. 이 포스트를 위한 예시로 a.shared.com, b.shared.com 이라는 가상의 도메인을 사용하기로 하자.

    # /etc/hosts
    127.0.0.1 shared.com
    127.0.0.1 a.shared.com
    127.0.0.1 b.shared.com

    경로 설정

    여기서는 shared 라는 디렉토리를 설명을 위한 루트 디렉토리로 한다. shared 아래에는 다음처럼 디렉토리를 설정하였다.

    • configs: 도메인별 설정 저장
    • contents: wp-content 디렉토리를 도메인별로 저장
    • core: 워드프레스 코어 파일

    코어 파일 다운로드

    한 벌의 코어를 사용하기 때문에 코어를 별도의 장소에 격리한다. shared/core가 그 장소이며, 저기에 워드프레스 코어 파일을 다운로드 받는다. 아래 간단한 한 줄 다운로드 예제 코드를 첨부한다.

    # 워드프레스 설치는 이 한줄로!
    wget https://wordpress.org/latest.tar.gz -O - | tar xzf - --strip=1 -C shared/core
    echo 'Completed!'

    아파치 서버 조정

    복잡한 설정이 필요한 nginx보다는 간단하게 쓸 수 있는 아파치를 선호한다. 첫번째 아파치 설정은 디렉토리 접근 허용이다.

    <Directory "shared">
    	AllowOverride All
    	Require all granted
    </Directory>

    두번째는 가상호스트 설정. /etc/hosts를 위한 도메인 설정은 와일드카드가 먹히지 않지만, 다행히 아파치 가상호스트에서는 ServerAlias로 와일드카드를 설정할 수 있다. 요즘 https를 많이 사용하므로 간단하게 자가서명한 인증서를 이용해 https 방식으로도 동작하게 해 뒀다.

    <VirtualHost *:80>
    	ServerName   shared.com
    	ServerAlias  *.shared.com
    	DocumentRoot shared/core
    	Alias        /contents shared/contents
    </VirtualHost>
    <VirtualHost *:443>
    	ServerName   shared.com
    	ServerAlias  *.shared.com
    	DocumentRoot shared/core
    	Alias        /contents shared/contents
    
    	SSLEngine On
    	SSLCertificateFile    apache2/ssl/apache2.crt
    	SSLCertificateKeyFile apache2/ssl/apache2.key
    </VirtualHost>

    wp-config.php 파일 설정 조정

    wp-config.php는 워드프레스 코어에 두어도 되고, 코어 파일이 있는 디렉토리의 하나 위에 두어도 된다. 여기서는 코어 디렉토리보다는 하나 위쪽인 shared/wp-config.php 파일을 두도록 하자. 그리고 여기서는 각 사이트를 위한 설정 파일을 인클루드한다.

    <?php
    $host   = $_SERVER['HTTP_HOST'] ?? '';
    $config = __DIR__ . "/configs/{$host}.php";
    
    if ( $host && file_exists( $config ) && is_readable( $config ) ) {
        require_once __DIR__ . '/configs/common.php';
        require_once $config;
    } else {
        die( 'Config file is missing!' );
    }
    
    /* That's all, stop editing! Happy publishing. */
    
    /** Absolute path to the WordPress directory. */
    if ( ! defined( 'ABSPATH' ) ) {
    	define( 'ABSPATH', __DIR__ . '/' );
    }
    
    /** Sets up WordPress vars and included files. */
    require_once ABSPATH . 'wp-settings.php';
    

    wp-config.php는 각 도메인마다 읽어야 할 설정 파일을 구분해서 읽도록 지시한다. 그리고 shared/config/common.php 파일에는 모든 사이트의 범용 설정을 작성할 것이다. 나는 데이터베이스를 하나로 잡고 마치 멀티사이트처럼 접두만 변경할 것이므로 접속 정보는 common.php에 작성할 것이다. 그리고 디버그 모드 같은 설정도 이곳에 공통 요소로 잡을 것이다.

    <?php
    define( 'DB_NAME', 'database_name_here' );
    define( 'DB_USER', 'username_here' );
    define( 'DB_PASSWORD', 'password_here' );
    define( 'DB_HOST', 'localhost' );
    define( 'DB_CHARSET', 'utf8' );
    define( 'DB_COLLATE', '' );
    
    define( 'WP_DEBUG', true );
    define( 'WP_DEBUG_DISPLAY', true );
    define( 'WP_DEBUG_LOG', false );
    define( 'WP_DISABLE_FATAL_ERROR_HANDLER', true );
    define( 'SCRIPT_DEBUG', true );
    

    그리고 shared/configs/a.shared.com.php, shared/configs/b.shared.com.php 두 파일을 적절히 생성한다.

    define('AUTH_KEY', '...');
    define('SECURE_AUTH_KEY', '...');
    define('LOGGED_IN_KEY', '...');
    define('NONCE_KEY', '...');
    define('AUTH_SALT', '...');
    define('SECURE_AUTH_SALT', '...');
    define('LOGGED_IN_SALT',  '...');
    define('NONCE_SALT', '...');
    
    $table_prefix = 'a_'

    각 KEY, SALT는 https://api.wordpress.org/secret-key/1.1/salt/ 에서 적절히 생성한 것을 사용한다. 개발 설정에서는 이 키를 common.php에 둘 수 있겠지만, 실서버 설정이라면 분리하는 것이 맞다. 그리고 $table_prefix 는 중요하다. 사이트마다 다른 문자열을 적용하여 다른 테이블을 사용하도록 설정하자. 물론, 의도적으로 같은 접두사를 쓰는 것도 가능하다.

    HTTPS로 리다이렉트

    자가인증서이긴 하지만 HTTPS 환경을 꾸미는데 부족함이 없다. http로 접속시 https로 리다이렉트하는 코드를 삽입하자.

    <IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{HTTPS} off
    RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301,QSA]
    </IfModule>

    WP-CONENT 디렉토리 변경

    여기까지 하면 도메인마다 다른 설정 파일과 다른 테이블을 이용하되 워드프레스 코어를 하나로 쓰는 것이 가능해진다. 그러나 아직 작업이 하나 더 남아있다. 여기까지 설정하면 모든 테마와 플러그인, 그리고 업로드 디렉토리 같은 wp-content 디렉토리를 공유하기 때문이다. 이것을 도메인별로 분리하는 작업을 더해야 한다.

    우선 shared/core/contents가 비어 있다. 여기에 a.shared.com, b.shared.com 두 도메인을 그대로 딴 디렉토리를 만들고, 생성된 디렉토리마다 wp-content의 index.php 파일과 plugins, themes, uploads 디렉토리를 복사해 넣는다.

    그리고 shared/configs/common.php 에 아래 설정을 덧붙인다.

    define( 'WP_CONTENT_DIR', "shared/contents/{$_SERVER['HTTP_HOST']}" );
    define( 'WP_CONTENT_URL', "https://{$_SERVER['HTTP_HOST']}/contents/{$_SERVER['HTTP_HOST']}" );

    이제 도메인마다 각자 다른 콘텐트 디렉토리를 가지게 된다.

    정리

    길게 늘여쓰기는 했지만 다음이 핵심이다.

    • shared 디렉토리에 configs, contents, core 세 디렉토리 생성후 각각 설정, wp-content, 코어 부분을 담당한다. 설정과 wp-content는 도메인마다 달라지므로 각각의 도메인으로 구분된 디렉토리별 관리를 한다.
    • configs 디렉토리에 common.php로 공통 설정을 두고, 각 도메인.php 파일을 읽도록 wp-config.php 파일 설정을 한다.
    • WP_CONTENT_DIR, WP_CONTENT_URL 도 shared/contents/{$HTTP_HOST}를 읽을 수 있도록 설정한다. 그리고 아파치 서버도 적절히 alias 설정을 해 두어 각 도메인별로 변경된 wp-content 접근이 가능하게 한다.
    • 각 도메인별 접근시 코어가 도메인별로 다른 설정 파일을 읽어 각자 다른 데이터베이스, wp-content (shared/contents/{$HTTP_HOST})를 이용하도록 한다.

    이렇게 하면 한 코어만 고정적으로 두고 새 워드프레스를 만들고 가볍게 삭제하는 것이 가능하다. 코어 업데이트도 단 한번이면 족하고, 사용 환경에 따라 장점이 많을 수 있다.

    그러나 이런 세팅을 사용해 개발을 몇 번 해 봤는데 단점도 있었다. 아무리 코어가 안정적이어도 코어의 환경이 변경되면 전에 없던 에러가 발생할 우려가 있기 마련이다. 때로는 스탠드얼론으로 모든 환경을 한 벌에 두고 안정적으로 두는 것이 더 나을 수도 있다.

    그리고 개발시 WP CLI를 자주 사용하게 되는데, 이 방법을 쓰는 경우 코어와 설정 등이 분리되어 있어 WP CLI를 사용하기 위해 추가적으로 파라미터를 더 지정해 줘야 하기 때문에 조금, 아니 꽤 불편하다는 단점이 있다. 이런 추가적인 설정을 계속해서 요구하기 때문에 오히려 더 번잡스러운 것이 아닌가 하는 생각도 좀 들었다. 워드프레스 코어 소스 파일이 많기는 하지만, 그렇다고 용량이 감당 못할 정도로 엄청난 것도 아니고…

    추가: 새 도메인에 새 워드프레스 추가하기

    이제 앞으로 새로운 도메인으로 워드프레스를 설치하려면 다음 순서대로 하면 된다.

    1. 새로운 도매인과 IP 매핑. e.g. /etc/hosts
    2. shared/contents 디렉토리에 도메인 이름으로 디렉토리 생성. 여기가 새 워드프레스의 wp-content 가 됨. 코어에 있는 wp-content/ 안의 내용을 복사하면 편하다.
    3. shared/configs 디렉토리에 도메인 이름.php 파일 생성. 여기에 적절한 설정을 붙인다. $table_prefix 변수는 반드시 여기서 설정해 두어야 한다.
    4. 새로운 도메인으로 접속하여 워드프레스 설치를 마친다.

  • 페이지 목록 관리의 깨알 팁

    페이지 목록 관리의 깨알 팁

    사이트 페이지 목록을 만들 때 정돈되어 있으면 더욱 효율적입니다. 메인 페이지나 중요한 페이지를 1페이지에 빠르게 로드할 수 있다면 더 좋겠지요? 이럴 때 쓰는 것이 페이지 “순서” 속성입니다.

    페이지 순서는 기본이 0입니다. 그래서 보통보다 뒤로 보내려면 양수를, 반대로 앞으로 가져오려면 음수로 둡니다. 그러면 1페이지 상위에 가장 자주 관리하는 메뉴를 먼저 볼 수 있게 되어 편리합니다.

    메인 페이지나 자주 편집하는 주요 페이지를 먼저 출력해 두면 편리합니다.
  • 디버그 로그는 가려놓읍시다!

    디버그 로그는 가려놓읍시다!

    워드프레스는 흔히 카페24 같은 호스팅을 사용한다든지, 이런 오픈된 개발 서버에서 작업되는 경우도 흔합니다. 그리고 워드프레스의 동작을 보다 정밀하게 파악하기 위해, 아래 같은 설정을 사용하기도 합니다.

    (더 보기…)
  • 커스텀 포스트가 관리자 페이지에서 일반 페이지처럼 템플릿을 선택할 수 있도록 하기

    커스텀 포스트가 관리자 페이지에서 일반 페이지처럼 템플릿을 선택할 수 있도록 하기

    register_post_type() 함수 인자에서 ‘support’ 항목에 ‘page-attributes’를 추가한다. 그리고 아래의 필터를 추가한다.

    <?php
    add_filter( 'theme_' . 'custom_post_type' . '_templates', 'my_templates', 10, 4);
    
    function my_templates( $post_templates, $wp_theme, $post, $post_type ) {
      if ( empty( $post_templates ) ) {
        $pt = $wp_theme->get_post_templates();
        $post_templates = $pt['page'] ?? array();
      }
      return $post_templates;
    }

     

  • 테마를 별도의 디렉토리로 옮기기

    개발 의도상 테마를 별도의 디렉토리에 두고 싶은 생각이 들었다. 플러그인을 놓고 쓰는 것처럼 말이다. 그런데 wp-config.php 코덱스를 참고해도 플러그인의 경로를 바꾸는 일은 허용되나, 테마에 대해서는 이런 설정이 공식적으로는 존재하지 않는다. 테마를 별도로 쓰려면,  wp-contents 디렉토리를 벗어나지 않는 한에서 변경하기를 권장하기도 한다.

    사실 실사용 서버에 이런 일을 할 필요는 없다. 단지 개발 서버상에서만 편하자고 하는 일이다.

    나는 코어와 플러그인의 디렉토리를 분리해서 사용한다. 이렇게 해서 여러 사이트에 대해 개발을 할 때 단 한 벌의 코어로 대응할 수 있다. 이렇게 사용하는 법은 다른 포스트를 통해 소개한 바 있다.

    테마 디렉토리는 플러그인과 같은 레벨에 둔다고 가정한다.  그리고 MU 플러그인을 하나 만들고 거기에 그냥 다음과 같이 적으면 된다.

    register_theme_directory( dirname(__DIR__) . '/themes' );

     이렇게 하면 이동한 테마 디렉토리에 있는 테마 목록이 워드프레스 ‘외모’메뉴에서 보이게 된다.

    그런데 이렇게만 하면 문제가 발생한다. 왜냐하면 이 시점에서 정적 자원들을 웹서버로 접근할 때의 URL이 정해지지 않았기 때문이다. 테마가 나오지만, 이미지나 자바스크립트는 404 에러를 내면서 죽을 것이다. 당연히 웹서버에 현재 /themes 디렉토리에 대해 URL로 접근할 수 있도록 처리해야 한다. 플러그인의 WP_PLUGIN_DIR과 WP_PLUGIN_URL 설정이 두 개로 나뉘어져 있는 것과 동일한 이치다.

    이 때는 아래와 같은 필터를 통해 해결할 수 있다.

    add_filter( 'theme_root_uri', function( $theme_root_uri, $site_url, $stylesheet_or_template ) {  
      $theme_root_path = dirname( __DIR__ );
      if( strpos( $theme_root_uri, $theme_root_path ) === 0 ) {
        return substr( $theme_root_uri, strlen( $theme_root_path ) );
      }
      return $theme_root_uri;
    }, 10, 3 );

     합쳐진 MU 플러그인의 레시피는 아래와 같다. 단, 완벽한 동작을 보장할 수 없으니 개발용으로만 참고하시라.

    <?php
    
    add_filter( 'theme_root_uri', function( $theme_root_uri, $site_url, $stylesheet_or_template ) {  
      $theme_root_path = dirname( __DIR__ );
      if( strpos( $theme_root_uri, $theme_root_path ) === 0 ) {
        return substr( $theme_root_uri, strlen( $theme_root_path ) );
      }
      return $theme_root_uri;
    }, 10, 3 );
    
    register_theme_directory( dirname(__DIR__) . '/themes' );