Установка и настройка DVelum 1.x

Системные требования

  • Linux (при запуске под windows возможны проблемы, ведем работы над совместимостью);
  • PHP 5.5  и выше;
  • Mysql 5.5  и выше;
  • веб-сервер Apache + mod_rewrite (AllowOverride All)  или Nginx + php-fpm;
  • желательно наличие memcached.

Установка

Настраивать DVelum (вносить изменения в файлы конфигурации платформы) необходимо после завершения процесса установки.

Файл .htaccess при инсталляции в подкаталог на веб-сервере Apache и конфигурацию самого веб-сервера Apache или Nginx само собой нужно настроить до начала установки.

Чтобы установить систему необходимо распаковать файлы на веб-сервер, настроить его конфигурацию так, чтобы папка www из каталога dvelum являлась Document Root. Начиная с версии dvelum 0.9.2 возможна установка во вложенную папку, например www.yoursite.com/dvelum/ (особенности настройки см. ниже).

Открыть браузер, запустить www.yoursite.com/install/, следовать инструкциям.

Пример конфигурации для Apache + mod_php + mod_rewrite (для установки в корень):


<VirtualHost *:80>
    ServerName dvelum.local
    ErrorLog logs/dvelum-error_log
    CustomLog logs/dvelum-access_log common
    DocumentRoot /var/www/dvelum/www
    <Directory "/var/www/dvelum/www">
        # Для Apache 2.4
        Require all granted

        # Для Apache 2.2
        #Order allow,deny
        #Allow from all

        AllowOverride All
        Options +ExecCGI -Includes -Indexes
     </Directory>
</VirtualHost>

Пример конфигурации для nginx + php-fpm (для установки в корень):

 # ....
    sendfile on;     
   keepalive_timeout  65;     
   tcp_nodelay  on;     
   gzip	on;     
   gzip_min_length	1100;     
   gzip_disable "MSIE [1-6]\.(?!.*SV1)";     
   gzip_proxied	any;     
   gzip_comp_level	4;     
   gzip_types text/plain text/css application/x-javascript text/xml application/xml application/xml+rss text/javascript;    
   gzip_vary  on;     
 # ....          

 upstream fpm_backend{ 	    
     server unix:/path/to/php-fpm.sock; 	
 }  	

server {
    server_name yoursite.com www.yoursite.com; 		
    listen 80; 	
    charset utf8; 		
    index index.php index.html; 	
			 		
    location / { 		    
      root /path/to/site/www; 		    
      index index.php; 		   
      try_files $uri $uri/ @your_site; 		
    } 		 		

   location ~* ^.+\.(ico|txt|jpg|jpeg|gif|png|svg|js|css|mp3|ogg|mpeg|avi|zip|gz|bz2|rar|swf)$ {
      root /path/to/site/www; 			
      access_log off; 			
      expires max; 		
   } 	

   location ~ .php$ { 		    
        index index.php;
        root /path/to/site/www;
        fastcgi_split_path_info ^(.+\.php)(.*)$;
        fastcgi_pass fpm_backend;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param DOCUMENT_ROOT /path/to/site/www;
        fastcgi_param SCRIPT_FILENAME /path/to/site/www$fastcgi_script_name;
        fastcgi_param PATH_TRANSLATED /path/to/site/www$fastcgi_script_name;
        fastcgi_param QUERY_STRING $query_string;
        fastcgi_param REQUEST_METHOD $request_method;
        fastcgi_param CONTENT_TYPE $content_type;
        fastcgi_param CONTENT_LENGTH $content_length;
   } 		 		
   location @your_site{ 		    
        index index.php; 		    
        root /path/to/site/www; 		    
        fastcgi_pass fpm_backend;
        include fastcgi_params;
        fastcgi_param DOCUMENT_ROOT /path/to/site/www;
        fastcgi_param SCRIPT_FILENAME /path/to/site/www/index.php;
        fastcgi_param PATH_TRANSLATED /path/to/site/www/index.php;
        fastcgi_param QUERY_STRING $query_string;
        fastcgi_param REQUEST_METHOD $request_method;
        fastcgi_param CONTENT_TYPE $content_type; 		    
        fastcgi_param CONTENT_LENGTH $content_length;
        fastcgi_intercept_errors on;
        fastcgi_ignore_client_abort off;
        fastcgi_connect_timeout 60;
        fastcgi_send_timeout 180;
        fastcgi_read_timeout 180;
        fastcgi_buffer_size 128k;
        fastcgi_buffers 4 256k;
        fastcgi_temp_file_write_size 256k;
   } 	

}


Открыть браузер, запустить www.yoursite.com/install/, следовать инструкциям.

 

Особенности установки в подкаталог

До начала установки необходимо дополнительно настроить Alias и Rewrite.

При этом Ваш сайт будет размещяться в /var/www/dvelum_sub (http://dvdsub.local), а DVelum - в /var/www/dvelum_sub/dvelum (http://dvdsub.local/dvelum)
 

Пример конфигурации для Apache + mod_php + mod_rewrite:

Вариант с виртуальным сервером:


<VirtualHost *:80>
    ServerName dvsub.local
    ErrorLog logs/dvsub-error_log
    CustomLog logs/dvsub-access_log common
    DocumentRoot /var/www/dvelum_sub
    <Directory "/var/www/dvelum">
        # Для Apache 2.4
        Require all granted

        # Для Apache 2.2
        #Order allow,deny
        #Allow from all

        AllowOverride All
        Options +ExecCGI -Includes -Indexes
    </Directory> 
    Alias /dvelum    /var/www/dvelum_sub/dvelum/www
</VirtualHost>

Вариант без виртуального сервера:


<Directory "/var/www/dvelum_platform">
   # Для Apache 2.4
   Require all granted

   # Для Apache 2.2
   #Order allow,deny
   #Allow from all

   AllowOverride All
   Options +ExecCGI -Includes -Indexes
</Directory>    
Alias /dvelum   /var/www/dvelum_platform/www

Где /var/www/dvelum_platform путь к корню DVelum.

В этом случае DVelum будет доступен как http://www.yoursite.com/dvelum

Также корректируем www/.htaccess:


AddDefaultCharset UTF-8
RewriteEngine on
RewriteBase /dvelum/
Options -Indexes
Options +FollowSymLinks
DirectoryIndex index.php

RewriteRule !(^js/.*|^i/.*|^res/.*|^media/.*|^css/.*|^favicon\.ico)$ index.php [NC,L]

Настройка после установки

Кэш

Желательно иметь установленный memcached (чтобы ощутить всю мощь производительности), в этом случае необходимо указать настройки подключения к memcached в файле application/config/local/cache.php (создать скопировав из application/config/dist/cache.php) и перевести систему на работу с этим сервером, указав в файле application/config/local/main.php

 'use_cache' => true

Настройка режима разработчика

Для того чтобы перевести систему в режим разработчика необходимо внести следующие изменения в конфигурацию системы в файле application/config/local/main.php (добавить параметры, либо изменить существующие при наличии):

 

Переключить режим работы:

'development' =>1 (или 2 для использование тестовой БД)

 

Желательно отключить кэширование и использование карты классов:

'use_cache' => false

'useMap' => false

Для использования тестовой БД необходимо указать параметры подключения к ней данных в файле application/config/local/db/dev/default.php или через интерфейс управления ORM.

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

Для удобства анализа ajax  запросов административной панели средствами подобными firebug рекомендуем отключить  CSRF токен
в application/config/local/backend.php:
'use_csrf_token' => false

Настройка системы на максимальную производительность

Установите следующие значения в основном файле конфигурации (application/config/local/main.php):

'development' => 0
'use_cache' => true
'useMap' => true