Дискретные проекты Yii на основе общего ядра

в 19:52, , рубрики: yii, Веб-разработка, распределённая система, метки: , ,

Дискретные проекты Yii на основе общего ядра
Добрый вечер всем читателям!

Хочу поделиться определёнными идеями и соображениями на тему создания обособленных проектов в Yii на основе одного общего ядра.

Некоторое время назад, перейдя по рабочей надобности с kohana на yii, я долго радовался его простоте и удобству, которые, как мне казалось, были в разы больше, чем у коханы (да простят меня любители этого фреймворка), а потом, все по той же рабочей надобности, пришлось углубиться в архитектуру Yii, и, частности, в возможности дистрибуции его проектов от одного обособленного ядра.

Изначально, что называется, «из коробки», Yii уже поставляется отдельными папками с самим ядром и несколькими демо-проектами на нам, но мне этого было мало, поскольку требовались несколько другие возможности по управлению и контролю за проектами, на основе чего и были созданы те идеи, которые я хочу изложить.

Маленькие оговорки

Начнем с того, что я не буду сейчас заморачиваться тонкими настройками апача, php, или иных вещей, потому что хочу изложить просто идею и узнать ваше, дорогие читатели, мнение о том, стоит ли развивать предложенный способ дальше и каким образом его можно модифицировать, потому сразу оговорюсь, что все описанные ниже действия происходят на свежеустановленной убунте 11.10 и традиционным lamp из коробки.
Так же предполагается, что читатель уже знаком с основами Yii и хотя бы примерно знает его структуру каталогов.

Подготовка

Итак, изначально у нас самый простой хост с примерно такими настройками:

<VirtualHost *:80>
	ServerName      demo.lori
	ServerAlias 	demo.lori www.demo.lori
	DocumentRoot 	/home/lori/workspace/demo.lori/www

	ErrorLog	/home/lori/workspace/demo.lori/logs/error.log
	CustomLog	/home/lori/workspace/demo.lori/logs/access.log common
</VirtualHost>

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

Папки логов были выбраны для более быстрого доступа к ним в процессе разработки (я не претендую на звание гуру в области юникса, и потому, если мне кто-то скажет, что это не кошерно, с радостью выслушаю).

Дополнительно, в папке workspace создаем папку с названием yii, куда распаковываем свежескаченный архив в Yii, а конкретнее, папку framework из него (на момент создания статьи последней стабильной версией фреймворка была 1.1.10). Отныне это и будет наше ядро, и (чисто теоретически, разумеется), в дальнейшем прикасаться к нему мы будем очень редко.

После этого в папке /home/lori/workspace/demo.lori/www организуем следующую структуру (согласно модифицированным для данного способа рекомендациям Yii):

www/
—— index.php
—— .htaccess
—— config/
——— devel/
———— <конфиг-файлы локации разработки>
——— stable/
———— <конфиг-файлы локации продакшена>
—— engine/
——— <файлы проекта проекта>
—— themes/
——— basic/ (название основной темы)
———— static/
————— images/
————— css/
————— js/
———— views/
————— <файлы всех наших view по темам>

Теперь, согласно указанной выше организации, все файлы проекта (контроллеры, компоненты, модели и прочее), будут храниться в папке engine, предназначение папки themes не меняется, здесь будут храниться темы и другой статичный контент вроде CSS- или JS-файлов. Папка config тоже остается канонической, однако, её внутренности несколько изменятся.

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

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

Создаем некий общий склад для наших проектов:

mkdir -p /home/projects/data/demo.lori

cd /home/projects/data/demo.lori

mkdir ./assets/stable
mkdir ./runtime/stable
mkdir ./upload/stable

mkdir ./assets/devel
mkdir ./runtime/devel
mkdir ./upload/devel

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

chown www-data -R /home/projects

(Тут тоже маленький вопросик знатокам *unix, есть ли какие-то замечания по поводу прав?)

Теперь все, что нам остается, это создать симлинки на эти папки в нашем проекте:

ln -s /home/projects/data/demo.lori/assets /home/lori/workspace/demo.lori/www/assets
ln -s /home/projects/data/demo.lori/runtime /home/lori/workspace/demo.lori/www/runtime
ln -s /home/projects/data/demo.lori/upload /home/lori/workspace/demo.lori/www/upload

На этом основные подготовки закончены, переходим непосредственно к настройке проекта.

Настройка точки входа

Начнём с файла index.php, он почти ничем не отличается от стандартной точки входа Yii, за исключением поправок на разделение локаций на девел и продакшн:

<?php

date_default_timezone_set('Europe/Moscow');
error_reporting(E_ALL);
ini_set('display_errors', 1);

// Подключаем Yii
$yii = dirname(__FILE__).'/../../yii/yii.php';

/*
  Определяем, в какой локации мы сейчас находимся.
  Тут возможны различные вариации, в зависимости от того окружения, где вы работаете.
  Хотелось бы услышать ваши предложения, как ещё можно хитро разделить эти локации.
*/
define('DEVELOP_LOCATION', (gethostname() == 'lori-desktop' ? 'devel' : 'stable'));

/*
  Некий свой способ  включить дебаг, подсмотренный на текущей работе.
  Носит исключительно костыльный смысл.
*/
if (array_key_exists('HTTP_LORI_DEBUG', $_SERVER) and $_SERVER['HTTP_LORI_DEBUG'] == 'DEBUG IT, DEBUG!')
{

    defined('YII_DEBUG') or define('YII_DEBUG',true);
    defined('YII_TRACE_LEVEL') or define('YII_TRACE_LEVEL', 10);
}

/*
  Способ корректно обработать невидимое перенаправление в .htaccess.
  Если кто подскажет более элегантное решение, буду рад, ибо гуголь не помог.
*/
if ($_SERVER['REQUEST_URI'] != $_SERVER['REDIRECT_URL'])
    $_SERVER['REQUEST_URI'] = $_SERVER['REDIRECT_URL'];

// Подключаем основной конфиг в зависимости от локации
$config = dirname(__FILE__).'/config/'.DEVELOP_LOCATION.'/main.php';

require_once($yii);

Yii::createWebApplication($config)->run();

Сам .htaccess выглядит на данный момент примерно так:

AddDefaultCharset	UTF-8

RewriteEngine		on
RewriteBase		/

RewriteCond %{REQUEST_FILENAME}	    -d
RewriteRule ^upload/(.*)$	    /forbidden	    [L]

RewriteCond %{REQUEST_FILENAME}	    -d
RewriteRule ^assets/(.*)$	    /forbidden	    [L]

RewriteCond %{REQUEST_FILENAME}	    !-f
RewriteRule ^assets/(.*)$	    /nofile	    [L]

RewriteCond %{REQUEST_FILENAME}	    !-f
RewriteRule ^upload/(.*)$	    /nofile	    [L]

RewriteCond %{REQUEST_URI}	    !^/assets
RewriteCond %{REQUEST_URI}	    !^/upload
RewriteRule ^(.*)$		    index.php	    [L]

Точки входа готовы, теперь необходимо настроить под них конфиги.

Настройка настроек :)

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

Для начала, в папке config/devel/ создаем файл main.php. Он будет выглядеть, как обычный main.php из конфига любого проекта на Yii, но мы внесем в него некоторые дополнения согласно нашей файловой организаци:

<?
return array(

	// Все файлы проекта у нас теперь находятся в папке engine
	'basePath'		=> dirname(__FILE__).'/../../engine/',
	'name'		=> 'Demo project',
    
	// Указываем новый путь к runtime для текущей локации
	'runtimePath' 	=> dirname(__FILE__).'/../../runtime/devel',
    
	// Указываем нашу тему по умолчанию из папки /themes
	'theme'		=> 'basic',

	'preload' 		=> ...,

	'import' 		=> ...,

	'defaultController' => 'default',

	// Здесь есть изменения в путях к некоторым папкам
	'components' => array(
		'assetManager' 	=> array(
		    'basePath'	=> dirname(__FILE__).'/../../assets/devel',
		),

		'user' 		=> ...,
		'db'		=> ...,

		'errorHandler' 	=> ...,
            
                'urlManager' 	=> array(
                        'urlFormat' 	=> 'path',
                        'rules'     		=> require_once dirname(__FILE__).'/routes.php',
                ),
            
		'log'		=> ...
	),

	'params'	=> require(dirname(__FILE__).'/params.php'),
);

В приведённом выше конфиге троеточия заменяют стандартные блоки кода, которых не касаются текущие изменения в файловой организации и которые потому не нуждаются в описании.
Дополнительно стоит сказать про настройку urlManager:
Мне не очень нравится, что по классической схеме роутинг путается с конфигом, потому я выношу его всегда в отдельный файл routes.php в той же папке, что и main.php, и содержит он обычную структуру вида

<?
return array(
    'var1' => 'value1'
);

Послесловие

На этом, в принципе, вся основная настройка проекта завершается — проект настроен.

Плюсы данного подхода:
— Обособленность проектов друг от друга
— Один движок на все проекты, что позволяет обновлять его или дополнять один раз и для всех проектов сразу
— Наличие разделения на локации разработки и продакшена, со своими конфигами и включаемыми файлами
— Удобство при работе с системами контроля версий вроде Git
— В какой-то мере отделённый от проекта каталог темизации

Минусы:
— пока не обнаружено

Данный подход нравится мне своей гибкостью, ведь, если разобраться, его можно достаточно серьёзно расширять, оперируя локациями через htaccess, создавая отдельные конфиги для различных окружений, и многое другое, при этом, не заботясь о том, чтобы каждый раз, при добавлении какой-нибудь плюшки в ядро, переносить изменения по всем своим проектам (ведь ядро, так же, как и любой проект, является само по себе проектом, который так же можно изменять на девел-локации и выгружать на продакшн.

Если у кого-то будут какие-то замечания или вопросы, я буду рад выслушать и по возможности ответить или исправить какие-то места в приведённом примере.

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

Спасибо всем, кто дочитал статью до конца!

Автор: Melorian

* - обязательные к заполнению поля


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js