Библиотека знаний - drupal

PHPExcel / PhpSpreadsheet

Anonymous (anonymous@undisclosed.example.com) — 2017-01-16T12:31:06+00:00

PHPExcel / PhpSpreadsheet

Несколько недель назад мне пришлось работать с файлами Excel в формате BIFF8 (Excel 97), т.к. заказчик не согласен был на экспорт данных в CSV. Spreadsheet_Excel_Writer вместе с Spreadsheet_Excel_Reader очень хорошо помогали мне раньше, но только с BIFF5. Поддержка таблиц BIFF8 долгое время была большой проблемой. поэтому я стал искать альтернативы.

После недолгих поисков, я наткнулся на PHPExcel, который поддерживает множество форматов чтения и записи с помощью одного API. Он распространяется по GNU Lesser General Public License? что дает вам право использовать его свободно в коммерческих продуктах. Форматы чтения и записи не ограничиваются файлами Excel. В этой статье я дам краткий обзор о того, что вы можете делать с помощью этой библиотеки.

Форматы чтения

Excel 2007 (SpreadsheetML)
BIFF5 (Excel 5.0/Excel 95
BIFF8 (Excel 97 и более поздние)
PHPExcel Serialized Spreadsheet
Symbolic Link
CSV

Форматы записи

Excel 2007 (SpreadsheetML)
BIFF8 (Excel 97 и более поздние)
PHPExcel Serialized Spreadsheet
PDF
HTML
CSV

Установка PHPExcel

Убедитесь что на вашем сервере стоит PHP 5.2.0 или старше и установлены следующие расширения: php_zip, php_xml и php_gd2. Вs можете скачать архив с PHPExcel с сайта проекта. Можно так же установить PEAR-пакет.

Создание таблицы

После распаковки скачанного архива, вы найдете папку Tests, в которой содержатся несколько демонстрационных файлов. Когда вы захотите использовать эту библиотеку, взгляните на эти примеры, чтобы познакомиться методами работы с PHPExcel.

Теперь вы готовы к созданию вашего первого файла Excel. После создания экземпляра класса, устанавливаются некоторые метаданные:

require_once 'PHPExcel.php';
$objPHPExcel = new PHPExcel();
// устанавливаем метаданные
$objPHPExcel->getProperties()->setCreator("PHP")
->setLastModifiedBy("Алексей")
->setTitle("Office 2007 XLSX Тестируем")
->setSubject("Office 2007 XLSX Тестируем")
->setDescription("Тестовый файл Office 2007 XLSX, сгенерированный PHPExcel.")
->setKeywords("office 2007 openxml php")
->setCategory("Тестовый файл");
$objPHPExcel->getActiveSheet()->setTitle('Демо');

Как вы можете видеть, практически везде в классе используется паттерн Fluent Interface (цепочка вызовов).

Имена методов говорят сами за себя. В результате выполнения этого кода создастся объект PHPExcel c метаданными, но без наполнения, кроме листа под названием "Демо". При создании объекта, первый лист создастся автоматически. Конечно, вы можете добавить еще листы, если это необходимо. Сейчас в качестве активного листа выбран первый. Этот лист Excel или Open Office покажут первым при открытии файла. Добавим "Привет, мир!" в таблицу:

  $objPHPExcel->setActiveSheetIndex(0)
              ->setCellValue('A1', 'Привет')
              ->setCellValue('B1', 'Мир!');

Обращаться к ячейкам можно через координаты Excel, например, "С3". Это не очень удобно, когда надо перебрать содержимое большого количества ячеек. К счастью есть другой метод для того чтобы обратиться к ячейке - с помощью координат X и Y:

setCellValueByColumnAndRow($column, $row, $value) Заметьте, что нумерация строк начинается с 1, то есть координаты ячейки "A1" будут (0,1). Последний шаг - сохраняем файл Excel на диск. Для этого надо создать объект для записи, используя PHPExcel_IOFactory. Второй параметр определяет формат файла.

  require_once 'PHPExcel/IOFactory.php';
  $objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel2007');
  // Если вы хотите, то можете сохранить в другом формате, например, PDF:
  //$objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'PDF');
  $objWriter->save('MyExcel.xslx);

Есть методы для изменения стиля, формата, слияния и проверки ячеек. Для более подробной информации - смотрите документацию.

Чтение таблицы PHPExcel так же способен читать данные из Excel файлов. В реальной программе это может быть использовано, например, для импорта списка продукции. Это может быть полезно, если вы хотите предложить клиенту загрузку непосредственно Excel файла, а не экспорт через CSV. Так как PHPExcel может открыть оба этих формата, вы можете предложить оба способа импорта, без особых усилий.

Чтение из файла так же просто как и запись в него. Вновь используется класс IOFactory для доступа к файлу:

  require_once 'PHPExcel/IOFactory.php';
  $objPHPExcel = PHPExcel_IOFactory::load("MyExcel.xlsx");

Использование итератора листов позволяет вам получить структуру файла. Следующий пример показывает, как это можно сделать:

  require_once 'PHPExcel/IOFactory.php';
  $objPHPExcel = PHPExcel_IOFactory::load("MyExcel.xlsx");
  foreach ($objPHPExcel->getWorksheetIterator() as $worksheet)
  {
      $worksheetTitle     = $worksheet->getTitle();
      $highestRow         = $worksheet->getHighestRow(); // например, 10
      $highestColumn      = $worksheet->getHighestColumn(); // например, 'F'
      $highestColumnIndex = PHPExcel_Cell::columnIndexFromString($highestColumn);
      $nrColumns = ord($highestColumn) - 64;
      echo "<br>В таблице ".$worksheetTitle." ";
      echo $nrColumns . ' колонок (A-' . $highestColumn . ') ';
      echo ' и ' . $highestRow . ' строк.';
      echo '<br>Данные: <table border="1"><tr>';
      for ($row = 1; $row <= $highestRow; ++ $row)
      {
          echo '<tr>';
          for ($col = 0; $col < $highestColumnIndex; ++ $col) 
          {
              $cell = $worksheet->getCellByColumnAndRow($col, $row);
              $val = $cell->getValue();
              $dataType = PHPExcel_Cell_DataType::dataTypeForValue($val);
              echo '<td>' . $val . '<br>(Тип ' . $dataType . ')</td>';
          }
          echo '</tr>';
      }
      echo '</table>';
  }

Используя всего три строки кода можно легко конвертировать файлы из одного формата в другой:

  $objPHPExcel = PHPExcel_IOFactory::load("XMLTest.xml");
  $objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel2007');
  $objWriter->save('covertedXml2Xlsx.xlsx');

Другое интересное решение - использовать бизнес-логику из Excel файла. Вместо повторного создания кода, вы можете выполнить код сохраненный в Excel.

Так же возможно (а еще и быстрее, чем создание с нуля) загрузить файл Excel, а затем добавить в него данные. Базовый файл можно хранить как шаблон и использовать, заполняя нужными данными. А когда меняется макет - просто менять шаблон.

Небольшое замечание

PHPExcel очень требователен к памяти. Для одной ячейки надо около 1КБ памяти. При работе с большими таблицами, вы можете столкнуться с определенными трудностями. Тем не менее, разработчики позаботились об этом предоставив механизм кэширования: CachedObjectStorageFactory. Что говорит об этом руководство:

Механизм кэширования ячеек позволяет PHPExcel манипулировать объектами потреблять меньше памяти в PHP, используя жесткий диск, APC, memcache или Wincache. Это позволяет работать с большими таблицами используя небольшие объемы памяти, хоть и платя за это скоростью обращения к ячейкам.

В будущем

PHPExcel не умеет создавать диаграммы - пока что. Это пока в планах, но работа над ними уже ведется. Возможно в следующем релизе можно будет создавать диаграммы.

Заключение

PHPExcel имеет большой набор методов, по настоящему нужных программисту. Документация хорошо структурирована и большое число демонстрационных файлов позволяет легко найти как нужно использовать класс. Кроме этого файлы документированы с помощью PHPDocBlocks, так что при использовании IDE, таких как ZendStudio или NetBeans, вы будуте получать подсказки по использованию методов классов.

В заключение: на PHPExcel определенно стоит обратить внимание, т.к. он может работать со многими форматами.

Как обновить поле field используя Fields API

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:18:40+00:00

drupal, cms

Как обновить поле field используя Fields API

Иногда не хочется использовать node_save, а поле сохранить надо, да еще желательно отработать все хуки. А как это делать см. ниже.

      $entity = new stdClass();
      $entity->nid = $nid;
      $entity->type = 'offer';
      $entity->field_offer_rate['und'][0]['value'] = carpot_certificate::count_purchased($nid)/self::count_views($nid);
      field_attach_presave('node', $entity);
      field_attach_update('node', $entity);

ВНИМАНИЕ!!! Необходимо указывать правильный тип материала, иначе не все поля будут иметь пред значения и данные будут пропадать.

Как программно отправить submit

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:44:15+00:00

drupal, js, java-script

Как программно отправить submit

Отправка формы с помощью js

var form = document.getElementById("form");
form.submit();

Как программно нажать кнопку submit через 5 секунд

var form = document.getElementById("form");
setTimeout('form.submit()', 5000);

Отправка формы с помощью js

<script> 
function submitform() 
{ 
    document.forms["search"].submit(); 
} 

</script> 

<form name="search" method="post" action="......" >  
... 
<a href="javascript: submitform()">Submit</a> 
</form>

Модули для Drupal

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:43:16+00:00

drupal

Модули для Drupal

D6

CCK

Computed Field
Content
Content Copy
Content Permissions
Fieldgroup
Node Reference
Number
Option Widgets
Text
User Reference

CTools

Bulk Export
Chaos Tools
Page Manager
Stylizer
Views content panes

Core - Optional

Comment
Database logging
Menu
Taxonomy
Update Status

Taxonomy

Taxonomy Manager

Date/Time

Date
Date API
Date Timezone

Development

Devel
Devel generate
Drush

Panels

Mini Panels
Panel nodes
Panels

Views

Views
Views Bulk Operations
Views Exporter
Views UI
Views XML

Voting

Fivestar
Fivestar Comments
Voting API

Profile

Advanced Profile Kit
Content Profile

Themes

Sweaver

Other

D7

CTools

Bulk Export
Chaos Tools
Page Manager
Stylizer
Views content panes

Core - Optional

Taxonomy

Taxonomy Manager

Date/Time

Date
Date API
Date Timezone

Development

Devel
Devel generate
Drush

Panels

Mini Panels
Panel nodes
Panels

Views

Views 2
Views 3
- Статьи

Voting

Profile

Profile 2

Themes

Sweaver

Other

Entity API
Drush

Дополнительно

Ссылки

Модули

Anonymous (anonymous@undisclosed.example.com) — 2011-11-05T14:12:06+00:00

Модули

http://drupal.org/project/views_php

Работа с модулями

views_php

Разработка

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:19:52+00:00

drupal, cms

Разработка

Подмена views SQL (override views)
Chaos tool suite: как использовать Ajax Responder
Внесение изменений в поля CCK
Создание Excel таблиц средствами PHP
Multistep AHAH forms with proper AHAH behavior
Использование Features API
http://abrdev.com/?p=380 [Search engines]
Как назначить тему админ-части для отдельного роута
Особенности работы с модулем features
Как программно отправить submit
Create a custom web services project in Drupal 7
Infinite Scroll jQuery plugin + jQuery Masonry for Drupal - Равномерное распределение контента + ленивая подгрузка контента
Autocomplete

Меню Роутинг

Параметры menu_items

    $item += array(
      'access arguments' => array(),
      'access callback' => '',
      'page arguments' => array(),
      'page callback' => '',
      'delivery callback' => '', //
      'title arguments' => array(),
      'title callback' => 't',
      'theme arguments' => array(),
      'theme callback' => '',
      'description' => '',
      'position' => '',
      'context' => 0,
      'tab_parent' => '',
      'tab_root' => $path,
      'path' => $path,
      'file' => '',
      'file path' => '',
      'include file' => '',
    );

Сборки друпал

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:18:29+00:00

drupal, cms

Сборки друпал

Магазин

Купонный сайт

Сайт-Визитка

Социальные-Сети

Ссылки

Anonymous (anonymous@undisclosed.example.com) — 2014-03-01T21:35:04+00:00

Ссылки

RU

EN

Видео уроки

Drupal и Базы данных

Anonymous (anonymous@undisclosed.example.com) — 2015-09-29T08:50:28+00:00

bd, drupal, postgres, mysql

drupal

Drupal и Базы данных

Статьи

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:19:41+00:00

drupal, cms

Статьи

Autocomplete

Anonymous (anonymous@undisclosed.example.com) — 2013-07-22T22:00:58+00:00

Autocomplete

function mymodule_myform() {
  $form['myfield'] = array(
    '#type' => 'textfield',
    '#title' => 'My field',
    '#autocomplete_path' => 'mymodule/autocomplete', // <--
  );
  $form['submit'] = array(
    '#type' => 'submit',
    '#value' => 'Submit',
  );
  return $form;
}

function mymodule_menu() {
  $items['mymodule/autocomplete'] = array(
    'page callback' => 'mymodule_autocomplete',
    'access arguments' => array('access content'),
    'type' => MENU_CALLBACK,
  );
  return $items;
}

function mymodule_autocomplete($string) {
  // для примера, возвратим заголовки нод
  $result = db_select('node', 'n')
    ->fields('n', array('title'))
    ->condition('title', '%' . db_like($string) . '%', 'LIKE')
    ->range(0, 10)
    ->execute();
 
  $matches = array();
  foreach ($result as $row) {
    $matches[$row->title] = check_plain($row->title);
  }
 
  drupal_json_output($matches);
}

Commerce

Anonymous (anonymous@undisclosed.example.com) — 2012-10-08T22:29:23+00:00

Commerce

Commerce
Commerce Kickstart

Разработки

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:14:27+00:00

drupal, cms

Разработки

http://cmlservice.com - Экспорт/Импорт данных из 1С и Drupal

Организация публикации на продакшен

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:14:43+00:00

drupal, cms

Организация публикации на продакшен

Workflow

Drush

Ссылки

http://xandeadx.ru/blog/drupal/502

Как назначить тему админ части для отдельного роута

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:14:59+00:00

drupal, cms

Как назначить тему админ части для отдельного роута

Drupal 7

// Назначаем след путям тему админ части
function module_name_admin_paths() {
  $paths = array(
    'user/*' => TRUE,
    'node/*/track' => TRUE,
    'node/*/log' => TRUE,    
  );
  return $paths;
}

Drush обновления сайтов (dev и live) из командной строки

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:16:44+00:00

drupal, cms

Drush обновления сайтов (dev и live) из командной строки

Допустим мы имеем сайт ( придумаем ему синоним @SITE) в двух и более редакциях, например:

1) Сайт в интернете видят все люди - @site.live
2) Сайт на локальной машине - @site.dev

обновляем файлы сайтов (откуда куда):

drush rsync @site.dev @site.live

обновляем только файловый контент сайтов (откуда куда)

drush rsync @site.dev:%files @site.live:%files

обновляем базы данных (при дополнительных параметрах, можно исключать/включать таблицы) (откуда куда)

drush sql-sync --no-cache @site.dev @site.live

Хотим посмотреть список включенных модулей удаленного сайта, и включить модули: admin_menu authcache

drush @site.live pml --status=enabled
drush @site.live en admin_menu authcache -y

Через drush мы экономим много времени на эти операции, если операции выполнять вручную: ставить галочки, копировать файлы, писать свои скрипты

Теперь опишу как мы обозначаем синонимы, оригинал примера тут http://drupalcontrib.org/api/drupal/contributions--drush--examples--exam… 1. Создаем файл site.aliases.drushrc.php в любом из каталогов ~/.drush, /etc/drush, там где установлен drush, либо прописываем дополнительный путь для каталога синонимов 2. Приведу пример своего файла в котором описан сайт с двумя версиями live - живой сайт на хостинге, dev - сайт на локальной машине

<?php
$aliases['dev'] = array(
'root' => '/var/www/site/',
'uri' => 'www.mysite.local',
);

$aliases['live'] = array(
'root' => '/home/user/projects/mysite',
'uri' => 'site.ru',
'remote-host' => 'mysite.ru',
'remote-user' => 'user-hosting',
'ssh-options' => '-p2222',

'path-aliases' => array(
      '%drush' => '/home/user/bin/drush/',
      '%drush-script' => '/home/user/bin/drush/drush',
      #'%root' => '/home/user/projects/site/sites/',
      '%dump-dir' => '/home/user/projects/site/dump/',
      '%dump' => '/home/user/projects/site/dump/sro.sql', 
      #'%files' => 'sites/site.com/files',
),
);
?>

Installation profiles

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:46:10+00:00

drupal

Installation profiles

Ссылки

Anonymous (anonymous@undisclosed.example.com) — 2011-11-25T12:32:49+00:00

Ссылки

http://stanlemon.net/projects/jgrowl.html

Модули для Drupal

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:13:44+00:00

drupal, cms

Модули для Drupal

Ссылки - (слайдер) для Views Exposed filter, синхронизация c inputs, определение максимальный цены max price
Popup -
FastFetch -
jGrowl -
Field Permissions Plus - для всех полей можно задать пермишины
Field Permissions - позволяет задать поля необходимые для установки пермишинов
Content Permissions -
Features -
Spaces -
Panels -
Persistent URL -
Chaos tool suite -
Context -
Strongarm -
jQuery UI -
Drush -
Strongarm - выгрузка variables в фичи ([http://css.mirocow.com/projects/strongarm/repository|fork])
Boxes -
IMCE SWFUpload -
Short URL -
Admin -
Panels Everywhere -
Panels Sections -
Custom Breadcrumbs -
Distro -
Skinr -
Display suite =
Demo - Demonstration site (Sandbox / Snapshot) -
Content Templates - темплайт хранится в БД
jQuery Map Hilight -
jQZoom - зумирование картинки (хорошо подойдет для оформления товаров в эл магазине)
Fancy Multiselect Jquery Multiselect - Красивый плагин для множественного выделения элементов
Form API Multiselect element Multiselect - Удобный способ отобразить выделенные пункты меню (просто перенести их в соседнее окно)
CCK Slider Widget
Views Slideshow: ImageFlow -
Highslide -
Chosen - D7 - красивый виджет для выбора пуктов <select>
MuchoMenu
views_php - D6, D7 (View Custom Field)

Drupal modules

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:19:31+00:00

drupal, cms, modules

Drupal modules

0-9

A

B

C

D

E

F

G

H

I

J

K

L

M

N

O

P

Q

R

S

T

U

V

W

Views

X

Y

Восстановление пароля на Drupal

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:20:19+00:00

drupal, cms

Восстановление пароля на Drupal

Сброс кеша, Перестройка регистра, перестройка меню

<?php
define('MAINTENANCE_MODE', 'update');
define('DRUPAL_ROOT', getcwd());
require_once DRUPAL_ROOT . '/includes/bootstrap.inc';
drupal_bootstrap(DRUPAL_BOOTSTRAP_FULL);
require_once DRUPAL_ROOT . '/includes/common.inc';
drupal_flush_all_caches(); // Сброс кеша
registry_rebuild(); // Перестройка регистра
drupal_theme_rebuild(); // Перестройка тем
echo 'Done';
?>

Восстановление пароля Drupal 7

<?php
 
define('DRUPAL_ROOT', getcwd());
 
require_once DRUPAL_ROOT . '/includes/bootstrap.inc';
drupal_bootstrap(DRUPAL_BOOTSTRAP_FULL);
require_once DRUPAL_ROOT . '/' . variable_get('password_inc', 'includes/password.inc');
$admin = user_load(1);
$pass = isset($_GET['pass'])? trim($_GET['pass']): 'pass';
$uid = isset($_GET['uid'])? trim($_GET['uid']): 1;
user_save($admin, array('pass' => $pass, 'name' => 'admin'));
$account = user_load($uid);
if(user_check_password($pass, $account)){
    echo "[OK]";
}

Скопировать код и выполнить его.

Ссылки

Anonymous (anonymous@undisclosed.example.com) — 2011-11-25T12:33:32+00:00

Ссылки

http://artreaktor.com/slider-tracker-slaider-dlya-views-exposed-filter-sinkhronizatsiya-c-inputs-opredelenie-maksimalnyi-t

Drupal

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:22:47+00:00

drupal, cms

Drupal

Модули - базовый список модулей
Сборки - Списки модулей для сборок (магазин, соц-сеть, сайт-визитка, купонные сайты итд)
Installation profiles - профили
Разработка
Статьи
Базы данных
Мои разработки
Скрипты
- Сброс кеша, Перестройка регистра, перестройка меню
- Восстановление пароля Drupal 7
Ссылки

Ubercart 2

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:20:00+00:00

drupal, cms

Ubercart 2

Ubercart 3

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:19:04+00:00

drupal, cms

Ubercart 3

Drupal Views

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:45:14+00:00

drupal, views

Drupal Views

// Группируем подзапросы 
$handler->query->where[0]['type'] = 'AND';
// Группируем подзапросы 
$handler->query->where[1]['type'] = 'OR';
$handler->query->where[1]['clauses'][0] = "node.uid = ***CURRENT_USER***";
// Избавляем себя от ошибок
$handler->query->where[1]['args'] = array();
// Группируем группы
$handler->query->group_operator = 'OR';

Алгоритм работы с git репозиторием

Anonymous (anonymous@undisclosed.example.com) — 2015-09-25T09:25:53+00:00

drupal, git, scm

Алгоритм работы с git репозиторием

GIT – удобная и быстрая децентрализованная система совместной разработки (репозитория).

Рассмотрим несколько приёмов работы с git.

Предварительный настройки git

Можно задать глобальную идентификацию:

git config --global user.name "You Name"
git config --global user.email you_name@you_domain.com

Это задаст ваше имя пользователя и почтовый адрес которыми будут подписываться ваши коммиты.

Распределённая разработка проекта

Условия:

Есть общий сервер git-server (которым, например, может выступать GitHub. Каждый разработчик работает с репозиторием проекта локальный и регулярно обмениваться информацией с общим сервером (выгружает свои изменений и закачивает общие) Инициализация

Перейдите в папку где будет размещаться ваш проект и выполните клонирование проекта с сервера:

git clone ssh://you_name@git-server.com/~/you_project

Протокол доступа к репозирорию зависит от настроек сервера. После выполнения создастся папка проекта you_project и в последующем проводить инициализацию больше не нужно.

Разработка

Перед началом разработки необходимо создать локальную ветку и связать её с удалённой (тоже выполнить нужно один раз):

git checkout -b my_branch origin/my_branch

При создании новых файлов необходимо их пометить на добавление в репозиторий:

git add myfile.txt myfile2.txt myfile3

или рекурсивно папки (указанием точки в конце пути)

git add new_path/.

После внесения изменений их необходимо зафиксировать в коммит: Указываем какие файлы нужно добавить в коммит:

git commit myfile.txt myfile2.txt myfile3

после чего потребуется ввести описание изменений или задать описание сразу (использоваться опцию -m):

git commit myfile.txt myfile2.txt myfile3 -m "описание изменений"

Чтобы закомминить все произведённые изменения репозитория можно выполнить (использоваться опцию -a):

git commit -a -m "описание изменений"

Оправка изменений на сервер: Для отправки измений на общий сервер выполняем:

git push

и все коммиты из локальной ветки будут добавлены в связанную ветку на сервере.

Получение последних изменений с сервера Когда нужно забрать изменения с общего сервера:

git pull

Локальная ветка сразу подтянит все изменений из связанной с ней веткой на сервере.

Для просмотра состояния репозитория регулярно выполняйте:

git status<note warning>warning</note>

Основные операции с git

GIT - удобная быстрая децентрализованная система совместной разработки (репозитория).

Создание репозитория (инициализация)

Создайте папку проекта или войдите в существующую папку с файлами проекта и выполните инициализацию репозитория:

git init

Будет создана начальная структура репозитория в папке .git

Добавление существующих файлов

После инициализации может потребоваться добавить существующие файлы в репозиторий.

Команда:

git add .

добавит все файлы (рекурсивно) в репозиторий.

Клонирование

Выгрузки локальной копии репозитория:

git clone ssh://server.example.com/path/to/Project

Внесение изменений

Мелкие поправки вносятся простым коммитом с последующим закидыванием изменений на сервер.

git add ...
git status
git commit -m "Commit message"

Первой команде в качестве аргументов следует указать имена добавляемых файлов. Следует заметить, что для git’а изменённый файл является новым объектом. Поэтому для того, чтобы обновить файл в репозитории, также как и добавить новый файл, следует выполнить для него git add перед коммитом.

git status

наглядно покажет состояние файлов вашего дерева (неизвестные системе файлы, изменённые, не изменённые, находящиеся в конфликте и т.д.)

Серьёзную работу следует вести в отдельных ветвях для облегчения процесса смешивания нитей разработки обоих участников процесса.

git branch new-feature
git checkout new-feature
…сделать что-нибудь…

git add ...
git commit -m "Commit message"

Команда git branch покажет, что у нас две ветви: master и new-feature. Командой checkout можно переключаться между ними (и делать затем коммиты в каждую, не затрагивая другую). Когда вы закончите разрабатывать новую возможность, настанет время примешать изменения в основную ветвь, master.

git checkout master
git merge new-feature

Отправка изменений и приём изменений основной ветки

Итак, у нас в ветви master имеются изменения, которые неплохо бы отдать своему коллеге (ну и выложить на сервер с целью последующего deploy’а новой версии).

git push origin

Чтобы получить изменения, следует сделать:

git pull origin

В некоторых случаях изменения с сервера невозможно автоматически добавить в вашу ветвь master, тогда вместо pull’a следует использовать merge:

git merge origin/master

…или, в плохом случае…

git merge -s resolve origin/master

Откуда взялся origin? Это имя удалённого репозитория, автоматически добавленное командой git clone. Источник клонирования.

Чистка репозитория

Проверка репозитория и очистка от мусора:

Профилактика репозитория:

git fsck

Подсчёт количества объектов и освобождаемого места при упаковке:

git count-objects

Переупаковка репозитория и удаление мусора:

git gc

Простой Drupal workflow

Anonymous (anonymous@undisclosed.example.com) — 2015-09-18T12:17:21+00:00

drupal, cms

Простой Drupal workflow

Несколько разработчиков, каждый работает на своем локальном сервере: нужно делиться изменениями Тестовый сервер: нужно переносить настройки и контент Боевой сервер: нужно переносить настройки, сохраняя контент

Что делать? Что нам нужно:

отслеживать изменения в конфигурации
переносить изменения в конфигурации

Подходы:

работать с миграциями изменений в БД
настройки - в код (code-driven development): экосистема Features
Drush: лучший друг разработчика
cc - очистка кэша
dl, en, dis - работа с модулями
sql-dump, sql-sync - работа с дампами БД
rsync - синхронизация файлов
remote-backup, remote-restore - бэкапы
Migraine: наш опыт
Migraine by Noosphere Networks

http://ashearer.com/software/server-administration/migraine

модификация для D6 by mukesh.agarwal17

http://www.blisstering.com/migraine-synchronize-your-development-staging-and-production-sites-databases-drupal-6

drush
скрипты для drush от Данила Семеленова
от Данила Семеленова

http://www.slideshare.net/drupalindia/migraine-drupal-syncing-your-staging-and-live-sites-presentation

Что делает Migraine Migraine: разделение таблиц config_tables: blocks blocks_roles boxes, filters filter_formats, imagecache_action, imagecache_preset… content_tables*: node, node_revisions, search_dataset, search_index, term_data, term_node… temp_tables: accesslog, watchdog… cache_tables: cache, cache_block, cache_filter, cache_menu, cache_page, cache_views… ignore_tables: …

- все таблицы content_type_ и content_field_ определяются как контентные автоматически

Расширения Drush

Оболочка для команд Migraine migrate-db-dump — создание дампа локальной БД migrate-db-restore — восстановление БД из локального дампа migrate - полная миграция сайта, включая исходные файлы и БД sync - cинхронизация файлов локальной версии сайта с удаленной. Что еще нужно подготовить /sites/xxxx для всех площадок aliases.drushrc.php: алиасы площадок @dev, @test, @prod, реквизиты доступа (см. drush/examples/example.aliases.drushrc.php) settings.php для индивидуальных настроек внутри /sites/xxxx

Migraine: workflow

Разработчик 1 Работаем над кодом и конфигурацией Делаем дамп migrate-db-dump (можно повесить на pre-commit hook для git)

возможно, занесение новых таблиц в tables.py или tables.php

commit, push

Разработчик 2 pull (возможно, разрешаем конфликты) Делаем migrate-db-restore Изменения в конфигурации мигрировали Migraine: workflow drush @dev migrate @test: drush @dev migrate-db-dump drush @dev sync @test миграция БД

drush @dev migrate @prod: drush @dev migrate-db-dump drush @dev sync @prod миграция БД (кроме содержимого контентных таблиц) (возможно) изменение схемы контентных таблиц (при изменении типов данных через CCK)

Migraine: плюсы и минусы Хорошо: таблицы классифицированы - больше думать не надо нет зависимости от предоставления модулями каких-то интерфейсов для экспорта-импорта

Плохо: в случае конфликтов разбираться в дампах тяжело, легко ошибиться каша остается кашей все равно приходится думать

Features

Code-driven development! Конфигурация - в код!

Features так или иначе умеют: типы нод, поля CCK, таксономия, imagecahe, роли и права, Views, Rules… Features: экосистема Features Ctools exportables Strongarm - переменные Boxes - кастомные блоки (альтернатива стандартному add block) Context - блоки, breadcrumbs и т.д. Diff - инструмент для работы с различиями в состояниях feature Анатомия feature feature - это модуль feature_name.info - мета-информация, зависимости feature_name.module - место для кастомного кода feature_name.features.inc feature_name.install

Фрагменты конфигурации: feature_name.context.inc feature_name.features.content.inc feature_name.views_default.inc feature_name.features.user_permission.inc … Возможные состояния feature Features сравнивает для feature: состояние кода (1) предыдущее состояние кода (2) актуальное состояние (обычно в БД) (3)

В зависимости от разницы между ними: Default: (1) == (3) или (3) не существует, для обновления feature достаточно обновления кода Overridden: (1)!=(3), для обновления feature нужно сделать revert

Needs review: (1)!=(2)!=(3), для обновления нужно разбираться вручную

Rebuildable (для faux-exportables): (1)!=(3), (3)==(2)

Workflow отдельно взятой feature Разработчик 1 Создание Включение Работа по изменению конфигурации Обновление кода commit, push Разработчик 2 pull Установка/Обновление из кода Конфигурация перенесена! Управление Features Веб-интерфейс Drush drush features (fl) - список всех доступных feature drush features-export (fe) [feature name] [component list] - создание новой feature с указанными компонентами drush features-update (fu) [feature name] - из БД в код drush features-revert (fr) [feature name] - из кода в БД drush features-diff (fd) [feature name] - различия между состоянием в кодe и в БД

Feature: без UI

Создание feature_name.info: мета-информаци, зависимости и т.д. feature_name.module: include_once('feature_name.features.inc'); feature_name.features.inc drush en feature_name drush fu feature_name Добавление чего-нибудь Добавляем зависимость в .info (например: features[views][] = "view_news") drush fu feature_name Подумаем о других Изменения не сводятся только к конфигурации. Но feature - модуль, поэтому есть hook_install() и hook_update().

включение модулей добавление ролей добавление словарей любой код … hook_update() - делимся с теми, кто работает параллельно drush updatedb -y && drush cc all hook_install() - делимся с новыми разработчиками Controller Feature: центр управления всем остальным Включаются все остальные features: dependencies[] = "feature_name_1" dependencies[] = "feature_name_2" …

hook_update и hook_install - отражают общие изменения в состоянии системы function feature_controller_update_6003() { $return = array(); $modules = array('feature_name_1', 'feature_name_2'); drupal_install_modules($modules); $return[] = array('success' ⇒ TRUE, 'query' ⇒ 'Enabling some cool features'); return $return; } Features: собираем все вместе project.profile: включаем необходимые модули и Controller Feature Работаем: пишем код, добавляем модули, меняем структуру и настройки, разрабатываем и подключаем новые features. Поддерживаем актуальность .install Controller Feature (пишем код вручную). Поддерживаем актуальность кода остальных features (drush fu feature_name) Вся история в репозитории в виде кода!

Features Хорошо: с кодом легко работать в системе контроля версий законченные куски функционала, которые можно использовать повторно красиво

Плохо: требует больше внимания к вынесению изменений в код на самом деле сложно правильно разделить на куски из-за зависимостей не все компоненты exportable (решаемо)