Правила работы с системой Корпорация 2 CMS

Основные правила при работе с системой Корпорация 2 на сегодняшнее число:

corp_runner.php - это файл с основными классами для загрузки веб-части программы.

1. Для программных частей мы используем ANSI-кодировку. На ansi работаем, т.к. php пока более корректно работает в ansi.

Наблюдались проблемы при работе с utf-8:

- Не корректная работа с session.

- Вставка не видимых символов, в результате, появлялись лишниие переводы каретки при операциях include/require.

- При переводе php-вывода в графический формат, не корретно работали команды рисования.

Для описаний и документации, используется кодировка в формате UTF-8.

Для файлов с переводами используем ANSI, при необходимости - UTF-8.

2. По умолчанию, используется кодировка windows-1251.

3. Все выводы информации на экран используем через ф-ции в Корпорации, а не на прямую echo или print (не обязательное требование).

$c->myecho('Текст') - вместо echo или print.

4. Все обращения к базе данных делаем через ф-ции к базе данных в Корпорации, а не на прямую вызываем.

База данных у нас в формате utf-8, а программная часть - в ansi.

5. Все поля преобразуем из utf-8 в текущую кодировку с помощью функций в Корпорации

и записываем обратно, тож преобразуя из текущей кодировку в utf-8.

$c->dc('Текст'); - Декодирование из utf-8 в текущую кодировку

$c->ec('Текст'); - Кодирование из текущей кодировки в utf-8.

6. Для более быстрого набора основного класса введена переменная $c - вместо $corp.

7. Первичные ключи генерируем с помощью ф-ции в Корпорации myid.

$c->myid();

8. Формат файлов перевода:

$this->s(array(

"Идентификатор перевода 1" => "Перевод 1",

"Идентификатор перевода 2" => "Перевод 2",

"Идентификатор перевода 3" => "Перевод 3"

)

)

Вывод на экран с переводом осуществляем, с помощью ф-ции:

$c->tr('Идентификатор перевода');

9. Во всех каталогах для описания функционала для программистов используется файл desc.

В компонентах так же предусмотрены каталоги с документацией.

Документировать работку каждой компоненты - обязательно.

Так же необходимо описывать назначение функций и переменных.

10. SQL-запросы обязательно выполнять, используя ф-ции Корпорации 2:

$c->q('SQL-запрос') - выполнение SQL-запроса без необходимости обработки информаиции.

$c->fetch($dataset) - Передвижение по источнику данных $dataset.

14.02.09, 9:14