phing.tasks.ext.SvnExportRevisionDiffTask

В последнее время в посещаемых мною форумах и конференциях часто всплывает тема деплоя php-приложений на production-сервер. Я решил поделиться собственным рецептом.

В распоряжении имеется:

1. svn-репозитарий с проектом.
2. ftp-доступ к рабочему серверу.
3. установленный и готовый к тяжёлой рутине phing

Сценарий работ следующий:

1. Сделать экспорт кода из svn
2. Подготовить его к загрузке (например убрать комментарии, “склеить” мелкие в один большой, удалить лишнее и т.п.)
3. Проверить на наличие ошибок (они могли попасть в репозитарий или образоваться на предыдущем шаге)
4. Закачать полученное на рабочий сервер.

Всё вроде бы просто, но смущает один момент – экспорт всего и вся. Со времени последнего обновления на сервере в репозитарии обновились 3 файла, а экспортировать нужно всё? Никак нет! Экспортировать будем только то, что изменилось. То есть первый шаг сценария будет выглядеть так:

1. Получить последнюю версию проекта на сервере – RevFrom
2. Получить последнюю версию проекта в репозитарии – RevTo
3. Экспортировать файлы, которые изменились или добавились c RevFrom до RevTo

Версию рабочего проекта, не мудрствуя лукаво, предлагаю хранить в текстовом файле. Например revision.txt. Версию проекта в репозитарии поможет узнать SvnLastRevisionTask. Неясным остался лишь момент – каким образом выяснить какие файлы изменились. Те, кто пользовались TortoiseSVN наверняка знают о чудесной его возможности – сравнить две ревизии и экспортировать “разницу”. Но svn в чистом виде такой возможности не предоставляет. Так что пришлось немного поработать.

Результатом работы стал класс – SvnExportRevisionDiffTask Принцип его работы таков: получаю список файлов для каждой ревизии в виде xml, потом эти списки сравниваются на предмет изменившихся или добавленных файлов. Список получается путём вызова svn, т.к. более удобного способа не нашлось.

Закачивать файлы будем посредством task-а, который я опубликовал ранее – FtpUploadTask.

Ну вот все вроде бы в сборе и можно приступать с сборке: раскладываем php-классы в соответствующие места, берём файл example.xml

<?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>

Открываем консоль, набираем phing -f example.xml и смотрим как вашу работу выполняет за вас бездушная машина…

Кстати говоря, эту задачу можно запускать не только вручную, но и например с помощью post-commit hook-а на репозитарии…

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