eZ publish: приложение PHP Killer — части 1-3

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

  EnabledModules себя.

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

  URLTranslaterionKeyword вы увидите больше, когда URLTranslaterionKeyword к статье eZ - по сути, она помогает создавать «красивые» URL-адреса, поэтому вместо http: //localhost/public/ezpublish_2_2_6/index.php/forum/forumlist/1/ вы может иметь http: //localhost/public/ezpublish_2_2_6/index.php/forum/.

  Sections позволяют вам иметь несколько «стилей» для вашего сайта (немного похоже на скины), каждый из которых имеет свой внешний вид и предлагает доступ к различным модулям публикации eZ.  В связи с этим DefaultSection сообщает eZ об опубликовании, какой из них использовать на домашней странице, или если неясно, какой стиль использовать в любой момент.  Я посмотрю больше на разделы в ближайшее время.

  После этого другие параметры, о которых вам нужно беспокоиться, относятся к модулям, например: 

 [eZAdMain]  AdminTemplateDir=templates/standard/  TemplateDir=templates/standard/ImageDir=images/standard/  Language=en_GB  DefaultCategory=1  DefaultSection=1 
  Вы увидите больше этого в ближайшее время.  В каждом из каталогов модулей публикации eZ вы найдете файл site.ini.txt , в котором указано значение каждой из этих переменных. 
  Кэширование 
  Помимо генерации заголовков HTTP, которые сообщают браузерам, что делать при кэшировании веб-страниц, eZ publish имеет свой собственный внутренний механизм кэширования, используемый для хранения «проанализированного» вывода.  После просмотра страницы eZ publish может предоставить кэшированную версию, а не перестраивать всю страницу, что повышает общую производительность.  Когда вы изменяете дизайн eZ publish, вам нужно знать, как работает кэширование, иначе вам будет интересно, почему вы не видите свои изменения.  Внутренний механизм кэширования используется в основном тремя способами: 

  Каталог [ezPublish_root]/classes/cache/ используется для хранения PHP-скриптов и переменных.  Содержимое site.ini будет найдено в разобранном виде вместе с переменными, которые eZ publish назначил для целого ряда операций.  Если вы вносите изменения в site.ini вам нужно удалить файлы в этом каталоге, чтобы изменения вступили в силу. 
  В site.ini вы найдете следующие настройки: 
 SiteCache=disabled  SiteCacheTimeout=60 
  SiteCache пытается кэшировать каждую страницу публикации eZ.  Это полезно только для сайтов, где большая часть контента является статической.  Например, для сайтов, использующих модуль форума, лучше оставить этот параметр отключенным.  SiteCacheTimeout сообщает eZ publish о том, когда кэшированная страница может считаться просроченной (в минутах) и требует повторного создания. 
  Для некоторых модулей, таких как статья eZ, вы также найдете параметр « PageCaching » в site.ini , который также можно включить или отключить.  Когда вы работаете над визуальным макетом такого модуля, как статья eZ, рекомендуется установить для этого параметра значение «отключено», чтобы вы могли видеть любые изменения по мере их внесения.  Кроме того, если вы публикуете статью, а затем вносите в нее изменения, вам необходимо удалить ее кэшированную версию в [ezPublish_root]/ezarticle/cache/ . 

  В административной части публикации eZ вы найдете инструмент администрирования кэша в разделе «Менеджер сайта» (второй справа).  Это хорошо работает, если у вас установлена ​​eZ publish под Linux, но, к сожалению, не с Windows (вам придется удалять кэшированные файлы вручную с помощью Explorer). 


  Going Global 
  Теперь у вас есть представление о том, как eZ публикации сочетаются друг с другом, пришло время приступить к тщательному применению вашего собственного дизайна (ну, на самом деле, моего - но притворитесь, что он ваш!). 
  Прежде чем вы начнете что-либо делать с eZ publish, вам нужен «эскиз» того, как вы хотите, чтобы ваш сайт выглядел.  Подвергнув вас собственному личному предубеждению, первое, что нужно сделать, это загрузить копию Opera с http://www.opera.com/download/ .  Почему?  Потому что, вообще говоря, если ваш дизайн выглядит правильно в Opera, он будет выглядеть правильно в любом другом браузере.  Если вы используете Windows, не-Java версия в порядке. 
  Я собрал простую HTML-страницу и таблицу стилей, которую я хочу «применить» для публикации в eZ.  Если вы скачаете sampler.zip , вы найдете простой дизайн того, как сайт должен выглядеть в HTML, вместе с файлом CSS.  Сайт будет очень простым - он будет использовать только модуль eZ article.  Однако то, что вы узнаете здесь, должно быть применимо к более сложным сайтам публикации eZ.  Стоит открыть файл sampler.html (из ZIP), пока вы читаете оставшуюся часть этой статьи, чтобы помочь визуализировать происходящее. 
  Каталог сайтов 
  Первый шаг - найти [ezpublish_root]/sitedesign/standard/ и скопировать его, который вам необходимо переименовать в [ezpublish_root]/sitedesign/phppoint/ .  Все дизайнерские работы вы сохраните в каталоге phppoint .  Это хорошая идея, чтобы оставить оригинальные каталоги нетронутыми, чтобы иметь примеры для работы. 


            


  Далее, от административного бэк-энда, направьтесь к менеджеру сайта (второй справа).  Представлением по умолчанию является «Список разделов».  Удалите разделы «Интранет», «Торговля» и «Новости», так как они вам не нужны, затем отредактируйте стандартный раздел, задав имя и дизайн сайта «phpPoint».  Далее вниз по странице редактирования вы увидите раздел под названием «столбцы».  Цель состоит в том, чтобы сразу четыре статьи появлялись на «главной странице», каждая из которых занимала всю ширину страницы.  Поэтому добавьте строку, а затем установите их все в «1 статью столбца» с категорией «Все». 
  Теперь перейдите к URLTranslator (третий справа) и переименуйте /section-standard в /section-phppoint , затем удалите остальные три. 
  Наконец, в site.ini обновите следующие переменные: 
 SiteDesign=phppoint  SiteStyle=ezpublish  SiteTitle=phpPoint  ...  EnabledModules=eZArticle;eZImageCatalogue;eZMediaCatalogue;  eZForm;eZStats;eZURLTranslator;eZSiteManager;eZUser  ...  URLTranslationKeyword=section-phppoint  Sections=disabled 
  Переменные SiteDesign указывают на то, что eZ публикует каталог, в который я буду помещать свой дизайн. SiteTitle - это заголовок, который отображается в верхней части браузера.  SiteStyle Я оставляю нетронутым, так как это относится к административному разделу SiteStyle .  Вы должны убедиться, что доступны только те модули, которые вы хотите использовать с EnababledModules переменной EnababledModules .  URLTranslation и Sections более подробно обсуждаются в разделе «Sections». 
  Наконец, очистите кеш в [ezpublish_root]/classes/cache/ . 
  Теперь вы готовы начать взлом! 
 frame.php 
  В вашем каталоге [ezpublish_root]/sitedesign/phppoint/ вы найдете файл с именем frame.php .  Этот файл в основном является основным шаблоном в публикации eZ: более или менее все ваши страницы создаются публикацией eZ через этот шаблон. 
  Прежде чем идти дальше, если вы позволите мне кратковременную рутину: это то, о чем на самом деле говорят шаблоны в PHP.  Как вы видели в этом обсуждении на форумах SitePoint , любая система шаблонов, которая не использует собственную языковую структуру и переменные PHP, является полной тратой времени, памяти и вычислительной мощности.  frame.php является ярким примером того, как следует создавать шаблоны. 
  Теперь, глядя на содержимое frame.php , вы увидите, что HTML перемежается с PHP.  Прежде чем редактировать его, я познакомлю вас с некоторыми примерами того, что вы там увидите.  Сначала у вас есть: 
 <title><?php  // set the site title   $SiteTitle = $ini->read_var( "site", "SiteTitle" );   if ( isset( $SiteTitleAppend ) )    print( $SiteTitle . " - " . $SiteTitleAppend );  else    print( $SiteTitle );   ?></title> 
  Здесь код сначала назначает переменную $SiteTitle , извлекая ее из объекта $ini с помощью read_var() .  Если вы совсем не уверены в используемом там синтаксисе, взгляните на вводное руководство Кевина Янка по объектно-ориентированному PHP . 
  После этого код проверяет переменную $SiteTitleAppend , которая, если она существует, обычно содержит что-то вроде заголовка статьи.  Если эта переменная не найдена, содержимое <title /> будет просто переменной $SiteTitle вы установили в site.ini . 
  Двигаясь дальше вниз по сценарию, вы получаете: 
 <img src="<? print $GlobalSiteIni->WWWDir; ?>/sitedesign/<?  print ($GlobalSiteDesign); ?>/images/ezpublish-yourcontentmadeeasy.gif"  height="20" width="290" border="0" alt="" /> 
  Вот eZ publish строит URL, выбирая URL сайта с помощью: 
 $GlobalSiteIni->WWWDir 
  Хорошо, как работают эти классы публикации eZ, не так ли?  Для тех, кто просматривал статьи Кевина Янка о платформе .NET , вы заметите удивительное сходство.  Как я уже упоминал в первой части этой серии, eZ publish также является фреймворком, разработанным специально для создания приложений PHP.  И это одна из вещей, о которых говорит хорошая структура: сделать вашу жизнь проще, предоставив хорошо разработанную библиотеку классов, которую вы сможете использовать повторно. 


  Во всяком случае, вернемся к делу.  Некоторые переменные, используемые в frame.php, описаны по адресу http://doc.ez.no/article/articleview/204/1/54/ .  Короче говоря, вот файл сэмплера, который вы видели ранее, примененный к frame.php.  Обратите внимание, что я буквально не все скопировал и вставил.  В частности, левое меню требует дополнительной работы, о которой я расскажу, когда рассмотрим модуль статьи eZ. 
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"              "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="no" lang="no">   <head>  <title><?php  // set the site title   $SiteTitle = $ini->read_var( "site", "SiteTitle" );   if ( isset( $SiteTitleAppend ) )    print( $SiteTitle . " - " . $SiteTitleAppend );  else    print( $SiteTitle );   ?></title>    <?php   // check if we need a http-equiv refresh  if ( isset( $MetaRedirectLocation ) && isset( $MetaRedirectTimer ) )  {    print( "<META HTTP-EQUIV=Refresh ".         "CONTENT="$MetaRedirectTimer; URL=$MetaRedirectLocation" />" );  }   ?>   <link rel="stylesheet" type="text/css"    href="<?        print $GlobalSiteIni->WWWDir;        ?>/sitedesign/<?            print ($GlobalSiteDesign);                        ?>/style.css" />   <script language="JavaScript1.2">  <!--//    function MM_swapImgRestore()   {      var i,x,a=document.MM_sr;      for(i=0;a&&i<a.length&&(x=a[i])&&x.oSrc;i++) x.src=x.oSrc;   }    function MM_preloadImages()   {      var d=document; if(d.images){ if(!d.MM_p) d.MM_p=new Array();      var i,j=d.MM_p.length,a=MM_preloadImages.arguments;      for(i=0; i<a.length; i++)          if (a[i].indexOf("#")!=0){              d.MM_p[j]=new Image; d.MM_p[j++].src=a[i];          }      }   }    function MM_findObj(n, d)   {      var p,i,x;  if(!d) d=document;      if((p=n.indexOf("?"))>0&&parent.frames.length) {        d=parent.frames[n.substring(p+1)].document; n=n.substring(0,p);      }      if(!(x=d[n])&&d.all) x=d.all[n];      for (i=0;!x&&i<d.forms.length;i++) x=d.forms[i][n];      for(i=0;!x&&d.layers&&i<d.layers.length;i++)        x=MM_findObj(n,d.layers[i].document);      return x;   }    function MM_swapImage()   {      var i,j=0,x,a=MM_swapImage.arguments; document.MM_sr=new Array;      for(i=0;i<(a.length-2);i+=3)      if ((x=MM_findObj(a[i]))!=null) {          document.MM_sr[j++]=x; if(!x.oSrc) x.oSrc=x.src; x.src=a[i+2];      }   }   //-->  </script>   <!-- set the content meta information -->   <meta name="author" content="<?php     $SiteAuthor = $ini->read_var( "site", "SiteAuthor" );    print( $SiteAuthor );   ?>" />  <meta name="copyright" content="<?php     $SiteCopyright = $ini->read_var( "site", "SiteCopyright" );    print( $SiteCopyright );   ?>" />  <meta name="description" content="<?php   if ( isset( $SiteDescriptionOverride ) )  {    print( $SiteDescriptionOverride );  }  else  {    $SiteDescription = $ini->read_var( "site", "SiteDescription" );    print( $SiteDescription );  }   ?>" />  <meta name="keywords" content="<?php  if ( isset( $SiteKeywordsOverride ) )  {    print( $SiteKeywordsOverride );  }  else  {    $SiteKeywords = $ini->read_var( "site", "SiteKeywords" );    print( $SiteKeywords );  }   ?>" />  <meta name="MSSmartTagsPreventParsing" content="TRUE" />   <meta name="generator" content="eZ publish" />   </head>   <body bgcolor="#FFFFFF" topmargin="6"    marginheight="6" leftmargin="6" marginwidth="6">   <table width="100%" border="0" cellspacing="0" cellpadding="0">  <tr>  <td class="sitetitle">phpPoint.com</td>  </tr>  </table>   <table width="100%" border="0" cellspacing="6" cellpadding="6">  <tr valign="top">  <td width="15%" class="menuback">   <!-- Left menu start -->   <?  $CategoryID = 0;  include( "ezarticle/user/menubox.php" );  ?>   <br />   <table class="menu">  <tr>  <td class="menuitem">  <a href="?PrintableVersion=enabled">Printable page</a>  </td>  </tr>  <tr>  <td class="menuitem">  <a target="_blank" href="http://developer.ez.no">  <img src="<?       print $GlobalSiteIni->WWWDir;     ?>/images/powered-by-ezpublish-100x35-trans-lgrey.gif"       width="100"       height="35" border="0" alt="Powered by eZ publish" /></a>  </div>  </td>  </tr>  </table>   <!-- Left menu end -->   </td>  <td width="95%">   <!-- Main content view start -->    <?   print( $MainContents );   ?>   <!-- Main content view end -->  </td>  </tr>  </table>   <?  // Store the statistics with a callback image.  // It will be no overhead with this method for storing stats  //   $StoreStats = $ini->read_var( "eZStatsMain", "StoreStats" );   if ( $StoreStats == "enabled" )  {    // create a random string to prevent browser caching.    $seed = md5( microtime() );    // callback for storing the stats    $imgSrc = $GlobalSiteIni->WWWDir . "/stats/store/rx$seed-" .                $REQUEST_URI . "1x1.gif";    print( "<img src="$imgSrc" height="1"".     &oo@