Правила работы с системой Корпорация 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.
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.
Комментарии