1.0Чудо{вищные} заметкиhttps://miracle.rpz.nameMiRacLehttps://miracle.rpz.name/author/miracle/phing.tasks.ext.SvnExportRevisionDiffTaskВ последнее время в посещаемых мною форумах и конференциях часто всплывает тема деплоя php-приложений на production-сервер. Я решил поделиться собственным рецептом.
В распоряжении имеется:
<ol><li>svn-репозитарий с проектом.</li><li>ftp-доступ к рабочему серверу.</li><li>установленный и готовый к тяжёлой рутине <a href="http://phing.info">phing</a>
</li></ol>
Сценарий работ следующий:
<ol><li>Сделать экспорт кода из svn</li><li>Подготовить его к загрузке (например убрать комментарии, "склеить" мелкие в один большой, удалить лишнее и т.п.)</li><li>Проверить на наличие ошибок (они могли попасть в репозитарий или образоваться на предыдущем шаге)</li><li>Закачать полученное на рабочий сервер.
</li></ol>Всё вроде бы просто, но смущает один момент - экспорт всего и вся. Со времени последнего обновления на сервере в репозитарии обновились 3 файла, а экспортировать нужно всё? Никак нет! Экспортировать будем только то, что изменилось. То есть первый шаг сценария будет выглядеть так:
<ol><li>Получить последнюю версию проекта на сервере - <i>RevFrom</i></li><li>Получить последнюю версию проекта в репозитарии - <i>RevTo</i>
</li><li>Экспортировать файлы, которые изменились или добавились c <i>RevFrom</i> до <i>RevTo</i>
</li></ol>
Версию рабочего проекта, не мудрствуя лукаво, предлагаю хранить в текстовом файле. Например revision.txt. Версию проекта в репозитарии поможет узнать SvnLastRevisionTask. Неясным остался лишь момент - каким образом выяснить какие файлы изменились. Те, кто пользовались TortoiseSVN наверняка знают о чудесной его возможности - сравнить две ревизии и экспортировать "разницу". Но svn в чистом виде такой возможности не предоставляет. Так что пришлось немного поработать.
<!--more-->
Результатом работы стал класс - <a href="http://miracle.rpz.name/shared/phing/SvnExportRevisionDiffTask.html">SvnExportRevisionDiffTask</a> Принцип его работы таков: получаю список файлов для каждой ревизии в виде xml, потом эти списки сравниваются на предмет изменившихся или добавленных файлов. Список получается путём вызова svn, т.к. более удобного способа не нашлось.
Закачивать файлы будем посредством task-а, который я опубликовал ранее - <a href="http://miracle.rpz.name/2007/11/15/phing-ftpupload-task/">FtpUploadTask</a>.
Ну вот все вроде бы в сборе и можно приступать с сборке: раскладываем php-классы в соответствующие места, берём файл example.xml
<pre class="xml:nocontrols">
<?xml version='1.0'?>
<project name='Deploy' default='build' basedir='./' description='Demo phing-ftp-deploy'>
<target name='propset'>
<property name='projectUrl' value='http://example.com/project_root/' />
<property name='revisionFile' value='revision.txt' />
<projectlastrev url='${projectUrl}' revisionFile='${revisionFile}' propertyName='fromrev' />
<property name='svnroot' value='http://svn.example.com/project/branches/stable/' />
<property name='svnuser' value='joe' />
<property name='svnpassword' value='s3cre7' />
<property name='outputdir' value='project-temp' />
<svnlastrevision username='${svnuser}' password='${svnpassword}' repositoryurl='${svnroot}' propertyName='torev' />
<property name='hostname' value='ftp.example.com' />
<property name='user' value='ftpuser@example.com' />
<property name='passwd' value='s3cr3tk3y' />
<property name='dstdir' value='project_root' />
<property name='overwrite' value='true' />
</target>
<target name='build' depends='propset,diff,lint'>
<ftpupload host='${hostname}' username='${user}' password='${passwd}' targetDir='${dstdir}' mode='bin' overwriteExisten='${overwrite}'>
<fileset dir='${outputdir}'>
<include name='**' />
<exclude name='config.php.dist' />
<exclude name='examples/**' />
</fileset>
</ftpupload>
</target>
<target name='diff' depends='propset'>
<delete includeemptydirs='true'>
<!-- сначала очистить директорию, в которую будут экспортироваться файлы -->
<fileset dir='.'>
<include name='${outputdir}/**' />
</fileset>
</delete>
<mkdir dir='${outputdir}' />
<!-- сохранить номер текущей ревизии в файл -->
<echo file='${outputdir}/${revisionFile}' message='${torev}' />
<!-- экспортировать нужные файлы -->
<svndiff toDir='${outputdir}' svnpath='/usr/local/subversion/bin/svn' fromRevision='${fromrev}' toRevision='${torev}' force='true' username='${svnuser}' password='${svnpassword}' repositoryurl='${svnroot}' />
</target>
<target name='lint'>
<phplint haltOnFailure='true'>
<fileset dir='${outputdir}'>
<include name='**/*.php'/>
<!-- файлы в pear::php_compat проверять в php5 не надо -->
<exclude name='**/Php/Compat/**/*.php' />
</fileset>
</phplint>
<jslint haltOnFailure='true'>
<fileset dir='${outputdir}'>
<include name='**/*.js'/>
</fileset>
</jslint>
</target>
</project>
</pre>
<p>Открываем консоль, набираем <b>phing -f example.xml </b> и смотрим как вашу работу выполняет за вас бездушная машина...
<p>
<blockquote>
Кстати говоря, эту задачу можно запускать не только вручную, но и например с помощью post-commit hook-а на репозитарии...
</blockquote>
<p>
Данный сценарий не затрагивает изменений в БД и позволяет синхронизировать только файлы, но и это, согласитесь, уже кое-что. А быть может у вас есть идеи, как обновить БД?rich