Разработка системы управления содержимым

Процесс разработки сайта является очень сложным и делом, который требует больше времени и внимания. Сайт должен быт простым, красивым и понятным. Данный продукт является системой, который можно создать простые блоги, сайты визитки или сайт новостей. Он создан в принципе MVC системы. Данный принцип является очень популярным и простым при разработке подобных систем.

В этом документе приведены все классы основные классы системы и функции с описанием. Он состоит из четырех разделов.

На первом разделе названием Регулярные выражении приведено описание функций, которые работает с регулярными выражениями.

Раздел Отправка писем содержит описание классов и функций который работает с отправкой электронных писем в системе.

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

1. РЕГУЛЯРНЫЕ ВЫРАЖЕНИЯ

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

1.1 Класс для работы с регулярными выражениями

Ниже приведено листинг класса для работы с регулярными выражениями. Название класса regular имеющий функции Activate, getResult, checkRegular.

Данная функция позволяет автоматически загрузить список всех регулярных выражений который используется в системе.

Листинг 1.1. Функция Activate

public static function Activate ()

{

include DIR_MODULES." regulars/regulars.php" ;

if (isset ($regs))

{self:$regulars = new params ($regs);}

else

{ self:$regulars = new params ();}

}

Функция chekRegular проверят на существования регулярного выражения в системе.

Листинг 1.2. Функция checkRegular

public static function checkRegular ($name)

{

return self:$regulars->is_isset ($name);

}

Функция выполняет проверку заданных данных с используя регулярных выражений и возвращает результат. Данная функция имеет два параметра первый object это значение который надо проверит и второй это filter_type который указывает тип фильтра.

Листинг 1.3. Функция getResult

public static function getResult ($object,$type,$filter_type="preg_match")

{ if (isset ($object) and $filter_type=="preg_match")

{ if (!self:$regulars->is_isset ($type))

{return false;}

else

{return preg_match (self:$regulars->getValue ($type),$object);}

}

elseif ($filter_type=="preg_match_all")

{if (!self:$regulars->is_isset ($type))

{return false;}

else

{$l = preg_match_all (self:$regulars->getValue ($type),$object,$mass);

return $mass;

}

}

}

1.2 Класс для проверки данных при регистрации

Данный класс позволяющий выполнить проверку данных пользователя. В классе создано функции login ,password, mail, dateage.

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

Листинг 1.4. Функция login

public static function login ($l)

{

if (!isset ($l))

{

self:$log['login'] = XATO_LOGIN_YOQ;

return false;

}

elseif (strlen ($l)<6 and strlen ($l)>12)

{

self:$l['login'] = XATO_LOGIN_KK;

return false;

}

elseif (!regular:getResult ($l,'login'))

{

self:$log['login'] = XATO_LOGIN_NOTOGRI;

return false;

}

elseif (data:$user->getValue («login» ," user_login='$l'"))

{

self:$log['login'] = XATO_LOGIN_MAVJUD;

}

else

{

return true;

}

}

Password - функция который проверятся с использованием регулярных выражений, сравнивает две пароли на правильность и возвращает данные шифрованный методом md5.

Листинг 1.5. Функция password

public static function password ($p1,$p2)

{

if (!isset ($p1) or! isset ($p2))

{

self:$log['password'] = XATO_PAROL_YOQ;

}

elseif (strlen ($p1)<6 and strlen ($p2)>12)

{

self:$log['password'] = XATO_PAROL_KK;

return false;

}

elseif ($p1==$p2)

{

self:$log['password'] = XATO_PAROL_OXSHASHMAS;

return false;

}

elseif (!regular:getResult ($p1,'password'))

{

self:$log['password'] = XATO_PAROL_NOTOGRI;

return false;

}

else

{

return true;

}

}

Функция mail проверят на корректность заданного электронного адреса.

Листинг 1.6. Функция mail

public static function mail ($m)

{

if (!isset ($m))

{

self:$log['mail'] = XATO_EMAIL_YOQ;

return false;

}

elseif (!regular:getResult ($m,'email'))

{

self:$log['mail'] = XATO_EMAIL_NOTOGRI;

return false;

}

elseif (strlen ($m)<6 and strlen ($m)>255)

{

self:$log['mail'] = XATO_EMAIL_KK;

return false;

}

else

{

return true;

}

}

2. ОТПРАВКА ПИСЕМ

Самый простой способ отправить письмо при помощи PHP — воспользоваться стандартной функцией mail. Она имеет следующий синтаксис:

bool mail (string to, string subject, string message [, string additional_headers [, string additional_parameters]])

2.1 Класс для отправки сообщений

Данный класс позволяет отправлять электронные письма в PHP и имеет опции задержки писем. В классе Mail имеется следующие функции Send, Delay, Abort, Complete.

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

· $to — электронная почта получателя

· $subject — тема отправляемого письма

· $message — текст отправляемого письма

· $from — адрес электронной почты отправителя

· $reply — адрес электронной почты который должен отправляется ответ.

Листинг 2.1. Функция Send

static function Send ($to, $subject, $message, $from, $reply = null){

if (empty ($reply)){

$reply = $from;

}

$reply = «Reply-To: $replyrn» ;

$headers = «MIME-Version: 1.0rn» .

" Content-Type: text/html; charset=UTF-8rn" .

" From: $fromrn" .

$reply.

" X-Mailer: PHP/" .phpversion ();

$subject = mb_encode_mimeheader ($subject, 'UTF-8', 'B', «rn», 9);

if (self:$delay){

self:$mail[] = array ($to, $subject, $message, $headers);

}else{

try{

mail ($to, $subject, $message, $headers);

}catch (Exception $e){

}

}

}

Функция Delay — включает задержку отправки писем.

Листинг 2.2. Функция Delay

static function Delay (){

self:$delay = true;

}

Функция Abort — отключает задержку отправки писем и очищает очередь писем.

Листинг 2.2. Функция Delay

static function Abort (){

self:$delay = false;

self:$mail = array ();

}

Complete — данная функция отправляет все письма из очереди и очищает очередь писем в конце отключая задержку писем.

Листинг 2.21. Функция Complete

static function Complete (){

try{

foreach (self:$mail as $m){

mail ($m[0], $m[1], $m[2], $m[3]);

}

}catch (Exception $e){}

Очищаем состояние задержки

self:Abort ();

}

2.2 Отправка ссылки для активации на почту пользователя

Данная функция отправляет письмо на почту нового пользователя с ссылкой активации его профиля.

Листинг 2.2. Функция Complete

public static function SendActivate ($mail,$login,$activation)

{

$subject = «Добро пожвловать в «.settings:getValue («site_name»);

$message = «Здраствуйте $login Для активации нажмите

Активация

Вам пришло этот сообщение потому что вы регистрировались в нашем сайте. Если это не вы тогда просто удалите данное сообщение;

$reply = settings: getValue («reply_email»);

Mail:Send ($mail,$subject,$message,$from,$reply);

Mail:Complete (); }

3. ОПИСАНИЕ КЛАССОВ

Данный сайт создан в принципе MVC и все его классы разделяются на три вида:

· Модель — классы, которые обеспечивает ввод и вывод данных

· Контроль — классы, которые обеспечивает за управлением, проверкой данных

· Просмотр — классы которые обеспечивает за отображением данных после обработки.

3.1 Классы типа модель

Классы данного типа являются data, db, getData.

· data - Данный класс позволяет обеспечить наследование класса getData.

· db - Это единственный класс который напрямую работает с БД. Он позволяет выполнить соединение, отключение, генерирования запросов и их выполнения.

· getData - данный класс является абстрактным. Он обеспечивает ввод и вывод данных.

3.2 Класс DB

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

Данная функция позволяет вводить настройки подключения к БД Он используется функцией connect для подключения.

Листинг 3.1. Функция db_conf

static function db_conf ($host,$dbase,$uid, $pwd, $connection_charset)

{

self:$config['host'] = $host;

self:$config['dbase'] = $dbase;

self:$config['pass'] = $pwd;

self:$config['user'] = $uid;

self:$config['charset'] = $connection_charset;

}

Функция который выполняет подключение к БД.

Листинг 3.2. Функция connect

public static function connect ()

{

self:$conn['con_desc']=mysql_connect (self:$config['host'], self:$config['user'], self:$config['pass']);

if (!self:$conn['con_desc'])

{

return false;

}

else

{

self:$conn['select_db']=mysql_select_db (self:$config['dbase'], self:$conn['con_desc']);

self:$conn['character']=mysql_query («SET NAMES «.self:$config['charset'], self:$conn['con_desc']);

}

return true;

}

Данная функция выполняется при загрузки класса и обеспечивает автоматическое подключение к БД.

Листинг 3.3. Функция Activate

public static function Activate ()

{

include DIR_CONFIG." data.config.php" ;

self:db_conf (DB_HOST, DB_BASE, DB_USER, DB_PASSWORD, DB_CHARSET);

}

Функция который выполняет отключение от БД.

Листинг 3.4. Функция disconnect

static function disconnect ()

{

mysql_close (self:$conn['con_desc']);

return true;

}

Функция который обеспечивает выполнение генерированных запросов.

Листинг 3.5. Функция query

static function query ($sql)

{

if (empty (self:$conn['con_desc']))

{

self:connect ();

}

if (!$result = mysql_query ($sql, self:$conn['con_desc']))

{

return false;

}

else

{

return $result;

}

}

Функция который на основе полученных данных генерирует запрос SQL для удаления.

Листинг 3.6. Функция delete

static function delete ($from,$where='', $field='')

{

if (!$from)

return false;

else

{

$table = $from;

$where = ($where ≠'')? «WHERE $where»: «» ;

return self: query («DELETE FROM $table $where»);

}

}

Функция для генерирования запроса SQL для вывода данных. После генерирования, используя, функцию query выполняет запрос и возвращает результат.

Листинг 3.7. Функция select

static function select ($from,$fields ='*', $where='',$orderby='',$limit='')

{

if (!$from)

return false;

else

{

$table = $from;

$where = ($where ≠"")? «WHERE $where»: «» ;

$orderby = ($orderby ≠"")? «ORDER BY $orderby »: «» ;

$limit = ($limit ≠"")? «LIMIT $limit»: «» ;

return self: query («SELECT $fields FROM $table $where $orderby $limit»);

}

}

Функция для генерирования SQL запроса обновления на основе полученных данных. Возвращает результат работы генерированного запроса.

Листинг 3.8. Функция select

static function update ($fields, $table, $where = «») {

if (!$table)

return false;

else {

if (!is_array ($fields))

$flds = $fields;

else {

$flds = '';

foreach ($fields as $key => $value) {

if (!empty ($flds))

$flds .= «,» ;

$flds .= $key. «=»;

$flds .= «'». $value. «'» ;

}

}

$where = ($where ≠ «»)? «WHERE $where»: «» ;

return self: query («UPDATE $table SET $flds $where»);

} }

Функция для генерирования SQL запроса который выполняет ввод данных. После генерирования используя функцию query выполняет генерированный запрос и возвращает номер добавленной строки.

Листинг 3.9. Функция insert

static function insert ($table,$params)

{

if (!isset ($table))

{

return false;

}

else

{

if (!is_array ($params))

{

$sql = «INSERT INTO $table $params» ;

}

else

{

$keys = array_keys ($params);

$vals = array_values ($params);

$fields = «(„.implode (“ ,» ,$keys).")" ;

$values = «('» .implode («','» ,$vals)." ')" ;

$sql = «INSERT INTO $table $fields VALUES $values» ;

}

}

$r = self: query ($sql);

return self: getInsertId ();

}

3.3 Функции класса getData

Данный класс является абстрактным. В нем имеется функции для ввода и вывода данных. Отличие от класса DB в том что при наследовании нужно указать таблицу который он должен работать.

Функция __construct автоматически работает при загрузки или наследовании класса. При наследовании нужно указать имя таблицы.

Листинг 3.10. Функция construct

public function __construct ($table_name)

{

if (isset ($table_name))

{

$this->table = $table_name;

}

else

{

return «EXIST_PARAMETERS» ;

}

}

Ниже приведенная функция позволяет выводить данные из таблицы. Имеется 4 параметра:

· $field — данном параметре можно указать поля таблицы

· $where — данный параметр позволяет выводить данные по условию

· $order_by — можно указать поля для сортировки и тип сортировки

· $limit — количество выводимых данных

Листинг 3.11. Функция getValue

public function getValue ($field,$where="" ,$order_by="" ,$limit="")

{

if (isset ($field))

{

if (isset ($this->table))

{

$result = db: select ($this->table,$field,$where,$order_by,$limit);

if (!$result)

{

return array ();

}

elseif (mysql_num_rows ($result)==1)

{

return mysql_fetch_assoc ($result);

}

else

{

$res = array ();

while ($e = mysql_fetch_assoc ($result))

{

$res[] = $e;

}

return $res;

}

}

else

{

return false;

}

}

else

{

return false;

}

}

Функция для ввода данных. Имеет один параметр который принимает тип массив.

Листинг 3.12. Функция addValue

public function addValue ($params)

{

if (is_array ($params))

{

return db: insert ($this->table,$params);

}

else

{

return false;

}

}

Функция setValue выполняет обновление данных таблицы. Здесь нужно указать имя поля таблицы и условие обновления.

Листинг 3.13. Функция addValue

public function setValue ($params,$where)

{

if (is_array ($params))

{

if (isset ($where))

{

return db: update ($params,$this->table,$where);

}

else

{

return «EXIST_PARAM_WHERE» ;

}

}

else

{

return «NOT_IS_ARRAY» ;

}

}

Функция delValue который имеет параметр $where позволяющий удалить данные. Для удаления надо указать имя значения. Функция принимает параметр where и тут можно указать имя значения и после значения удаляется.

Листинг 3.11. Функция addValue

public function delValue ($where)

{

if (isset ($where))

{

return db: delete ($this->table,$where,$field);

}

else

{

return «EXIST_PARAMS» ;

}

}

3.4 Функции класса data

Данный класс имеет одну функцию Activate который при загрузки выполняет наследование класса getData.

Листинг 3.12. Функция addValue

public static function Activate ()

{self:$user = new getData («user»);

self:$user_info = new getData («user_info»);

self:$rights = new getData («rights»);

self:$comments = new getData («comments»);

self:$pages = new getData («pages»);

self:$file = new getData («files»);

self:$type = new getData («types»);

self:$settings = new getData («settings»);

self:$online = new getData («online»);

self:$poseshenie = new getData («poseshenie»);

self:$templates = new getData («templates»); }

3.5 Классы типа контроллер

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

3.6 Класс Eagle

Eagle - системный класс который включается в index.php. выполняет автоматическую загрузку классов системы. Классе созданы следующие функции

Start - функция который запускает все необходимые модули системы и проверяет установлена ли система. Если система не установлено то он запускает установку системы.

Листинг 3.13. Функция start

public static function Start ()

{

проверка на установки системы

self:$is_install = is_file (DIR_CONFIG." data.config.php");

настройка PHP

ini_set ('magic_quotes_gpc', 0);

ini_set ('magic_quotes_runtime', 0);

ini_set ('magic_quotes_sybase', 0);

ini_set ('url_rewriter.tags', '');

ini_set ('register_globals', 0);

регистрация метода обработчика завершения системы

register_shutdown_function (array («eagle» ," Stop"));

загрузка модуля управления модулями

include_once (DIR_CORE." system/module.php");

Актиация модулья

module:Activate («module»);

if (self:$is_install)

{

module:Activate («errors»);

module:Activate («events»);

module:Activate («params»);

module:Activate («db»);

module:Activate («session»);

module:Activate («dbget»);

events:Execute («START»);

}

else

{

Начало установки системы

}

}

3.7 Класс Events

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

Activate - функция для активации модуля. Он автоматически запускается модулем Module.

Листинг 3.13. Функция start

public static function Activate ()

{

self:LoadHandlers (DIR_CONFIG.self:FILE_HANDLERS);

self:LoadHandlers (DIR_CONFIG.self:FILE_HANDLERS_MODULE);

}

LoadHandlers - функция который загружает реестр событий из конфигурационного файла.

Листинг 3.14. Функция LoadHandlers

public static function LoadHandlers ($config_file)

{

if (is_file ($config_file))

{

include $config_file;

}

else

{

exit («