Как управлять несколькими приложениями в CodeIgniter

Russian (Pусский) translation by Masha Kolesnikova (you can also view the original English article)

Сегодня мы рассмотрим, как вы можете управлять несколькими приложениями в веб-фреймворке CodeIgniter с использованием единой кодовой базы. В ходе этого мы продолжим работу и создадим два разных приложения CodeIgniter, которые будут совместно использовать общую кодовую базу CodeIgniter.

Совместное использование общей кодовой базы в разных приложениях не является чем-то новым, поскольку оно уже практикуется различными системами и системами с открытым исходным кодом, и CodeIgniter не является исключением. Он легко позволяет вам управлять несколькими приложениями, которые совместно используют основную библиотеку CodeIgniter и файлы API, и в то же время вы можете использовать разные базы данных и конфигурации сайтов.

Начнем с того, что мы воспользуемся преимуществами многосайтовой настройки, и по мере продвижения мы рассмотрим практическую демонстрацию того, что нужно для создания нескольких приложений в рамках CodeIgniter.

Преимущества многопосайтовой настройки

В этом разделе мы остановимся на нескольких преимуществах многоуровневой настройки.

Одна из самых очевидных преимуществ, которые я могу сразу отметить, заключается в том, что многоуровневая установка имеет общую кодовую базу, что значительно облегчит процесс обновления и обслуживания вашего приложения.

Например, давайте представим, что у вас есть десять различных приложений CodeIgniter, работающих под вашим поясом. И вы только узнали, что новая версия Framework CodeIgniter доступна для обновления, и вы хотели бы как можно быстрее обновить ее, чтобы убедиться, что код остается безопасным и стабильным.

Если у вас есть отдельная база кода для каждого из ваших приложений, то определенно будет утомительным процессом проходить через каждый сайт и обновлять его по очереди. Благодаря многоуровневой настройке вам просто нужно сделать это один раз, когда основная кодовая база будет доступна для всех сайтов!

Затем он позволяет использовать другую базу данных для каждого приложения, даже если они имеют общую базу кода. На самом деле, это один из самых популярных вариантов использования мультисайта!

Помимо использования другой базы данных для каждого приложения, вы можете создать установку, которая использует одну и ту же базу данных, но другую тему или макет в интерфейсе.

Если вы по-прежнему используете подход на основе FTP для перемещения файлов сайта на разных серверах, я бы сказал, что вам понравится многоуровневый подход, поскольку он в значительной степени минимизирует вашу работу!

Как создать несколько приложений

В этом разделе мы создадим базовую структуру каталогов, чтобы реализовать многоуровневую настройку.

В корне вашего приложения CodeIgniter создайте каталог applications. Это основной каталог, который будет содержать наши различные приложения.

Затем создайте два новых каталога: application/app_one и applications/app_two. Конечно, вы могли бы назвать его так, как хотите, но сейчас я все упрощу.

Итак, как вы можете видеть, мы собираемся настроить два разных приложения, которые будут использовать единую базу кода Framework CodeIgniter. Хотя многоузловая установка будет повторно использовать большинство файлов фреймворка CodeIgniter, нам по-прежнему нужно дублировать пару файлов и каталогов для каждого создаваемого нами приложения.

Позвольте мне быстро перечислить файлы и каталоги, которые вы должны скопировать из приложения по умолчанию в первую очередь.

Скопируйте следующие каталоги из каталога приложений по умолчанию в applications/app_one и applications/app_two:

cache
config
logs

Как вы можете видеть, очевидно, что для каждого приложения есть отдельные каталоги для cache и logs. И каталог config необходим для работы вашего приложения CodeIgniter, поэтому мы все равно его скопируем.

Затем скопируем несколько файлов вместе с необходимыми каталогами, которые позволят нам протестировать наше многоуровневое приложение.

Скопируйте следующие файлы в приложения app_one и app_two из приложения CodeIgniter по умолчанию:

controllers/welcome.php
views/errors
views/welcome_message.php

Для быстрой ссылки файл controller/welcome.php должен выглядеть следующим образом:

<?php
defined('BASEPATH') OR exit('No direct script access allowed');

class Welcome extends CI_Controller { 

    /**
     * Index Page for this controller.
     *
     * Maps to the following URL
     *         https://example.com/index.php/welcome
     *    - or -
     *         http://example.com/index.php/welcome/index
     *    - or -
     * Since this controller is set as the default controller in
     * config/routes.php, it's displayed at http://example.com/
     *
     * So any other public methods not prefixed with an underscore will
     * map to /index.php/welcome/<method_name>
     * @see https://codeigniter.com/user_guide/general/urls.html
     */
    public function index()
    {
        $this->load->view('welcome_message');
    }
}

А так должен выглядеть файл views/welcome_message.php.

<?php
defined('BASEPATH') OR exit('No direct script access allowed');
?><!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>Welcome to CodeIgniter</title>

    <style type="text/css">

    ::selection { background-color: #E13300; color: white; }
    ::-moz-selection { background-color: #E13300; color: white; }

    body {
        background-color: #fff;
        margin: 40px;
        font: 13px/20px normal Helvetica, Arial, sans-serif;
        color: #4F5155;
    }

    a {
        color: #003399;
        background-color: transparent;
        font-weight: normal;
    }

    h1 {
        color: #444;
        background-color: transparent;
        border-bottom: 1px solid #D0D0D0;
        font-size: 19px;
        font-weight: normal;
        margin: 0 0 14px 0;
        padding: 14px 15px 10px 15px;
    }

    code {
        font-family: Consolas, Monaco, Courier New, Courier, monospace;
        font-size: 12px;
        background-color: #f9f9f9;
        border: 1px solid #D0D0D0;
        color: #002166;
        display: block;
        margin: 14px 0 14px 0;
        padding: 12px 10px 12px 10px;
    }

    #body {
        margin: 0 15px 0 15px;
    }

    p.footer {
        text-align: right;
        font-size: 11px;
        border-top: 1px solid #D0D0D0;
        line-height: 32px;
        padding: 0 10px 0 10px;
        margin: 20px 0 0 0;
    }

    #container {
        margin: 10px;
        border: 1px solid #D0D0D0;
        box-shadow: 0 0 8px #D0D0D0;
    }
    </style>
</head>
<body>

<div id="container">
    <h1>Welcome to CodeIgniter! You're browsing Application One!</h1>

    <div id="body">
        <p>The page you are looking at is being generated dynamically by CodeIgniter.</p>

        <p>If you would like to edit this page you'll find it located at:</p>
        <code>application/views/welcome_message.php</code>

        <p>The corresponding controller for this page is found at:</p>
        <code>application/controllers/Welcome.php</code>

        <p>If you are exploring CodeIgniter for the very first time, you should start by reading the <a href="user_guide/">User Guide</a>.</p>
    </div>

    <p class="footer">Page rendered in <strong>{elapsed_time}</strong> seconds. <?php echo  (ENVIRONMENT === 'development') ?  'CodeIgniter Version <strong>' . CI_VERSION . '</strong>' : '' ?></p>
</div>

</body>
</html>

Конечно, вы должны изменить следующее сообщение в файле отображения, чтобы мы могли отличать приложение во время тестирования.

Для applications/app_one/views/welcome_message.php это должно выглядеть так:

1	<h1>Welcome to CodeIgniter! You're browsing Application One!</h1>

А для applications/app_two/views/welcome_message.php это должно выглядеть так:

1	<h1>Welcome to CodeIgniter! You're browsing Application Two!</h1>

Теперь мы сделали все, что касается нашей многоуровневой установки. Однако она не будет работать из коробки, но нам все равно нужно сообщить CodeIgniter о нашей настройке, так как она всегда загружает приложение по умолчанию, находящееся в каталоге application.

Последние штрихи

Давайте быстро рассмотрим настройку, которая настраивает каталог приложений по умолчанию. Откройте файл index.php в корневой папке приложения и найдите следующий фрагмент кода.

/*
 *---------------------------------------------------------------
 * APPLICATION DIRECTORY NAME
 *---------------------------------------------------------------
 *
 * If you want this front controller to use a different "application"
 * directory than the default one you can set its name here. The directory
 * can also be renamed or relocated anywhere on your server. If you do,
 * use an absolute (full) server path.
 * For more info please see the user guide:
 *
 * https://codeigniter.com/user_guide/general/managing_apps.html
 *
 * NO TRAILING SLASH!
 */
$application_folder = 'application';

Из приведенного выше фрагмента ясно, что он позволяет вам установить путь к вашему приложению по умолчанию. Таким образом, это место, где мы можем вносить изменения, чтобы он выбирал приложение по умолчанию из другого каталога, отличного от стандартного.

Конечно, вы могли бы пойти вперед и сразу сделать что-то подобное, и это должно запустить приложение app_one.

1	$application_folder = 'applications/app_one';

С другой стороны, что бы вы сделали, если хотите запустить app_two? Как быстро, вы можете скопировать файл index.php в index_app_one.php и index_app_two.php для каждого приложения. В своем виртуальном хосте убедитесь, что вы внесете соответствующие изменения.

С другой стороны, я предпочитаю несколько иной подход, и я хотел бы полагаться на переменную ENV, чтобы выбирать между различными приложениями во время выполнения.

Например, вы можете настроить пользовательскую переменную ENV в NGINX, как показано в следующем фрагменте.

1	// set the env variable CI_DEFAULT_APP in the "location" directive of vhost
2	fastcgi_param CI_DEFAULT_APP applications/app_one;

Если вы используете веб-сервер Apache, то это может быть достигнуто с помощью:

1	SetEnv CI_DEFAULT_APP applications/app_one

Затем переведем код в файл index.php, который использует переменную ENV, чтобы принять решение о запуске приложения по умолчанию.

...
...
$application_folder = (isset($_SERVER['CI_DEFAULT_APP']) ? $_SERVER['CI_DEFAULT_APP'] : 'application');
...
...

Итак, как вы можете видеть, мы сначала проверяем наличие переменной CI_DEFAULT_APP ENV, и если она недоступна, мы вернемся к приложению по умолчанию.

Чаще всего вы хотите запускать различные приложения в разных доменах. В идеале я хотел бы использовать два разных виртуальных хоста для каждого приложения. Быстрый пример каждого виртуального хоста должен выглядеть примерно так в контексте NGINX.

Домен www.ci-app-one.com указывает на app_one:

server {
  listen {YOUR_IP}:80;
  server_name  www.ci-app-one.com;
  root   /var/www/html;
  index index.html index.php;

  location ~* \.(jpg|jpeg|gif|css|png|js|ico|html)$ {
    access_log off;
    expires max;
  }

  location / {
     # Check if a file or directory index file exists, else route it to index.php.
     try_files $uri $uri/ /index.php;
  }

  location ~ \.php$ {
    root   /var/www/html;
    fastcgi_split_path_info ^(.+\.php)(.*)$;
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME  /var/www/html$fastcgi_script_name;
    fastcgi_param  CI_DEFAULT_APP  applications/app_one;
    include fastcgi_params;
  }
}

Аналогично, домен www.ci-app-two.com указывает на app_two:

server {
  listen {YOUR_IP}:80;
  server_name  www.ci-app-two.com;
  root   /var/www/html;
  index index.html index.php;

  location ~* \.(jpg|jpeg|gif|css|png|js|ico|html)$ {
    access_log off;
    expires max;
  }

  location / {
     # Check if a file or directory index file exists, else route it to index.php.
     try_files $uri $uri/ /index.php;
  }

  location ~ \.php$ {
    root   /var/www/html;
    fastcgi_split_path_info ^(.+\.php)(.*)$;
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME  /var/www/html$fastcgi_script_name;
    fastcgi_param  CI_DEFAULT_APP  applications/app_two;
    include fastcgi_params;
  }
}

Конечно, вы можете пойти еще дальше и проверить свои изменения, чтобы увидеть, действительно ли это работает или нет! Не стесняйтесь присылать мне любые вопросы, если у вас возникнут какие-либо проблемы.

И это был довольно простой способ, с помощью которого можно создать несколько приложений в рамках CodeIgniter с использованием единой кодовой базы.

Заключение

Сегодня мы рассмотрели интересный аспект фреймворка CodeIgniter, который позволяет управлять несколькими приложениями с использованием одной кодовой базы. Очевидными преимуществами этого являются простое обновление и обслуживание существующей кодовой базы.

CodeIgniter - мощный фреймворк PHP. Не забудьте также проверить, что у нас есть для вас.

Поделитесь своими мыслями, если вы уже внедрили нечто подобное, или вы бы приблизились к этому несколько иначе. В любом случае, я хотел бы услышать ваши мысли!