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

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-а на репозитарии…

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

Собственно сам класс FtpUploadTask.php. И небольшие пояснения.

Код по означенной ссылке необходимо сохранить в файл %PHING_HOME%/classes/phing/tasks/ext/FtpUploadTask.php (Разумеется вы уже знаете что такое Phing и он у вас установлен и готов к использованию).
Для работы требуется установленный в include_path PEAR::Net_FTP, которому в свою очередь необходим php-extension FTP.

На заметку виндузятникам
Первое можно установить посредством выполнения магического пасса в командной строке:
>pear install –all-deps net_ftp
Второе в виндовом php уже вкомпилено.

Параметры, которые принимает task (на всякий случай на моём террибл инглиш ):

И пример использования : привожу часть build.xml необходимую и достаточную для запуска таска.

<!-- //skip -->
<taskdef classname="phing.tasks.ext.FtpUploadTask" name="ftpupload" />
<!-- //skip -->
<target name="deploy">
   <ftpupload host="example.com" username="joe" password="$ecr3t" targetDir="/remote/project_home/">
      <fileset dir="/path/to/local/project">
         <include name="**" />
         <exclude name="**/*.dist" />
         <exclude name="src/*" />
      </fileset>
   </ftpupload>
</target>
<!-- //skip -->

Разумеется taskdef удобнее перенести в defaults.properties, для того чтобы не таскать его из проекта в проект.

И снова повторюсь – “таким образом программист может за три часа написать программу, которая сделает за пять минут то, что другой человек делал бы целый час…” ;o)

Technorati Tags: php, phing, deploy