Клас для додавання опцій до сайту

за Ніколаєнко Максим · Опубліковано Липень 31, 2014 · Оновлено Серпень 27, 2020

Зміст приховати

Передмова до уроку

Працюючи з CMS WordPress мені дуже подобалася ідея опцій у плагінах, які можна використовувати як в адмінці, так і на стороні користувача. У ці опції може бути поміщена як технічна інформація при розробці (дані для підключення до бази, зберігати список довільних полів, зберігати опції, які відносяться до окремих типів даних), так і якісь статичні дані, які виводяться на всіх сторінках (адресу, телефон, Назва сайту, гасло). Такі опції дуже корисні для виведення контактних даних, які змінюватися не часто, але найчастіше знаходяться в різних частинах коду і шукати їх дуже незручно.

Від слів до справи

Думаю з вступ закінчили і перше що я вам дам це код самого класу.

<?php
	class optionsClass {
		var $option;
		var $value;
		var $autoload;
		var $new_value;
		var $prefix;
		
		var $db;
		var $error;
		
		function __construct($db, $prefix){ // создает таблицу в базе даных с нужным префиксом, сразу после подключения класса
			if(!$db || !$prefix){
				$this->error[] = 'Не хватает параметров';
			exit;
			}
			$this->db = $db;
			$this->prefix = $prefix;
			$createTable = '
				CREATE TABLE `'.$prefix.'_options` (
				  `option_id` bigint(20) unsigned zerofill NOT NULL AUTO_INCREMENT,
				  `option_name` varchar(64) DEFAULT NULL,
				  `option_value` longtext,
				  `autoload` varchar(20) DEFAULT NULL,
				  PRIMARY KEY (`option_id`)
				) ENGINE=MyISAM DEFAULT CHARSET=utf8;
			';
			$query = 'select * from `'.$prefix.'_options`';
			$result = mysql_query($query , $this->db);
			if($result === false){
				$result = mysql_query($createTable , $this->db);
			} 
		}
		
		function get_option( $option, $default='' ){ // достаем опции из базы
			$query = "select option_value from ".$this->prefix."_options WHERE option_name='".$option."'";
			$result = mysql_query($query , $this->db);
			$row = mysql_fetch_array($result);
			
			if($row['option_value']){ return $row['option_value']; }else{ $this->error[] = 'Опция не найдена'; return false; }
		}

		function add_option($option, $value, $autoload='yes'){
			if($this->is_name_options($option) == false){ // Добавляем опции
				$query = "INSERT INTO ".$this->prefix."_options (option_name, option_value, autoload) VALUES ('".$option."', '".$value."', '".$autoload."')";
				$result = mysql_query($query , $this->db);
				if(!$result){
					$this->error[] = 'Не удалось добавиь опцию в базу данных';
				}else{
					$this->error[] = 'Опция ("'.$option.'" => "'.$value.'") добавлена в базу данных в базу данных';
				}
			}else{
				$this->error[] = 'Имя не уникально';
				return false;
			}
			
		}
		
		function is_name_options($option_name){ // проверяем наицие опции в базе
			if(isset($option_name)){ 
				$query = "select * from ".$this->prefix."_options WHERE option_name='".$option_name."'";
				$result = mysql_query($query , $this->db);
				$row = mysql_fetch_array($result);
				if($row){ return true; }else{ return false; }
			}else{
				$this->error[] = 'Опция не задана';
			}
		}
		
		function update_option($option, $value){ // Обновляем опции
			if($this->is_name_options($option)){
				$query = "update ".$this->prefix."_options SET option_value='".$value."' WHERE option_name='".$option."'";
				$result = mysql_query($query , $this->db);
				if($result){ $this->error[] = 'Опция '.$option.' обновлена'; }else{ $this->error[] = 'Опция '.$option.' не обновлена'; }
			}else{
				$this->error[] = 'Нет такой опции ['.$option.'] в базе';
			}
		}

		function delete_option($option){ // удаляем опции
			if($this->is_name_options($option)){
			//echo $option; exit;
				$query = "delete from ".$this->prefix."_options WHERE option_name='".$option."'";
				//echo $query ;
				$result = mysql_query($query , $this->db);
				if($result){ $this->error[] = 'Опция '.$option.' удалена'; }else{ $this->error[] = 'Опция '.$option.' не удалена'; }
			}else{
				$this->error[] = 'Нет такой опции ['.$option.'] в базе';
			}
		}
		
		function load_alloptions(){ // вывести на экран все опции
			$query = "select option_name, option_value from ".$this->prefix."_options";
			$result = mysql_query($query , $this->db);
			while($row = mysql_fetch_array($result)){
					echo '[ '.$row['option_name'].' ] => [ '.$row['option_value'].' ]<br />';				
			}
		}
		
		function log(){ // лог операций и ошибок
			if($this->error){
				echo '<pre>';
				print_r($this->error);
				echo '</pre>';
			}
		}
	}
?>

100

101

102

103

104

105

106

107

108

<?php

class optionsClass {

var $option;

var $value;

var $autoload;

var $new_value;

var $prefix;

var $db;

var $error;

function __construct($db, $prefix){ // создает таблицу в базе даных с нужным префиксом, сразу после подключения класса

if(!$db || !$prefix){

$this->error[] = 'Не хватает параметров';

exit;

}

$this->db = $db;

$this->prefix = $prefix;

$createTable = '

CREATE TABLE `'.$prefix.'_options` (

`option_id` bigint(20) unsigned zerofill NOT NULL AUTO_INCREMENT,

`option_name` varchar(64) DEFAULT NULL,

`option_value` longtext,

`autoload` varchar(20) DEFAULT NULL,

PRIMARY KEY (`option_id`)

) ENGINE=MyISAM DEFAULT CHARSET=utf8;

$query = 'select * from `'.$prefix.'_options`';

$result = mysql_query($query , $this->db);

if($result === false){

$result = mysql_query($createTable , $this->db);

}

function get_option( $option, $default='' ){ // достаем опции из базы

$query = "select option_value from ".$this->prefix."_options WHERE option_name='".$option."'";

$result = mysql_query($query , $this->db);

$row = mysql_fetch_array($result);

if($row['option_value']){ return $row['option_value']; }else{ $this->error[] = 'Опция не найдена'; return false; }

}

function add_option($option, $value, $autoload='yes'){

if($this->is_name_options($option) == false){ // Добавляем опции

$query = "INSERT INTO ".$this->prefix."_options (option_name, option_value, autoload) VALUES ('".$option."', '".$value."', '".$autoload."')";

$result = mysql_query($query , $this->db);

if(!$result){

$this->error[] = 'Не удалось добавиь опцию в базу данных';

}else{

$this->error[] = 'Опция ("'.$option.'" => "'.$value.'") добавлена в базу данных в базу данных';

}

}else{

$this->error[] = 'Имя не уникально';

return false;

}

function is_name_options($option_name){ // проверяем наицие опции в базе

if(isset($option_name)){

$query = "select * from ".$this->prefix."_options WHERE option_name='".$option_name."'";

$result = mysql_query($query , $this->db);

$row = mysql_fetch_array($result);

if($row){ return true; }else{ return false; }

}else{

$this->error[] = 'Опция не задана';

}

function update_option($option, $value){ // Обновляем опции

if($this->is_name_options($option)){

$query = "update ".$this->prefix."_options SET option_value='".$value."' WHERE option_name='".$option."'";

$result = mysql_query($query , $this->db);

if($result){ $this->error[] = 'Опция '.$option.' обновлена'; }else{ $this->error[] = 'Опция '.$option.' не обновлена'; }

}else{

$this->error[] = 'Нет такой опции ['.$option.'] в базе';

}

function delete_option($option){ // удаляем опции

if($this->is_name_options($option)){

//echo $option; exit;

$query = "delete from ".$this->prefix."_options WHERE option_name='".$option."'";

//echo $query ;

$result = mysql_query($query , $this->db);

if($result){ $this->error[] = 'Опция '.$option.' удалена'; }else{ $this->error[] = 'Опция '.$option.' не удалена'; }

}else{

$this->error[] = 'Нет такой опции ['.$option.'] в базе';

}

function load_alloptions(){ // вывести на экран все опции

$query = "select option_name, option_value from ".$this->prefix."_options";

$result = mysql_query($query , $this->db);

while($row = mysql_fetch_array($result)){

echo '[ '.$row['option_name'].' ] => [ '.$row['option_value'].' ]<br />';

}

function log(){ // лог операций и ошибок

if($this->error){

echo '<pre>';

print_r($this->error);

echo '</pre>';

}

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

Конструктор класу – перевіряє, чи є у базі даних таблиця опцій, якщо її немає, то самостійно створює цю таблицю. Конструктор приймає змінну підключення до бази даних $db та змінну префікс таблиць $prefix. Якщо немає змінних $db або $prefix, то як $error записується повідомлення про помилку і програма зупиняється.

метод get_option() необхідний для виведення однієї опції, яка вже є в базі. Тут робиться проста вибірка, думаю, якщо ви працюєте з ОВП, то про це можна вже не говорити.

метод add_option($варіант, $value) необхідний для додавання нових опцій до бази, якщо опція із зазначеним ім'ям вже існує, то у властивість $це->помилка додається повідомлення, яке розробник може вивести для себе або відвідувачів сайту за допомогою методу журнал().

метод is_name_options() допомагає перевірити, чи є опція із запропонованим ім'ям у таблиці опцій.

метод update_option() оновлює дані у вже існуючих опціях. Приймає 2 обов'язкових параметрів $варіант і $value (ім'я опції та значення).

Метод класу delete_option() необхідний видалення непотрібних опцій, якщо така існує у базі даних. Опція перевіряється і якщо було знайдено, то видаляється з бази на ім'я.

метод load_alloptions() призначений для виведення на екран усіх опцій, ця функція потрібна виключно для перегляду опцій розробником.

Про метод журнал() ми вже говорили, цей метод призначений для виведення всіх повідомлень, які потрапили в масив властивості $це->помилка.

Робота з класом опцій

Зараз, коли ми розглянули всі методи, можна плавно перейти до роботи з нашим класом.

Оскільки клас у нас працює через базу даних, то для початку нам необхідно її створити та підключиться, а таблицю вже створить наш клас.

$db = mysql_connect('localhost', 'db', 'wp-admin');
if (!$db) {
	die('Could not connect: ' . mysql_error());
}

mysql_select_db( 'db-name', $db );

$db = mysql_connect('localhost', 'db', 'wp-admin');

if (!$db) {

die('Could not connect: ' . mysql_error());

}

mysql_select_db( 'db-name', $db );

Далі підключаємо наш клас та пробуємо його використовувати:

include './optionsClass.php';
	$prefix = 'cl';
	$obj = new optionsClass($db, $prefix);
	$obj->add_option('optionsName',12);
	//$obj->update_option('optionsName',13);
	//$obj->delete_option('optionsName');
	$obj->load_alloptions();
	$opt = $obj->get_option('optionsName');
	echo $opt;
	
	$obj->log();
mysql_close($db);

include './optionsClass.php';

$prefix = 'cl';

$obj = new optionsClass($db, $prefix);

$obj->add_option('optionsName',12);

//$obj->update_option('optionsName',13);

//$obj->delete_option('optionsName');

$obj->load_alloptions();

$opt = $obj->get_option('optionsName');

echo $opt;

$obj->log();

mysql_close($db);

Пограйте з методами класу та спробуйте за допомогою методів додавати нові опції, виводити їх на екран, оновлювати дані в опції, видаляти опції. Обов'язково спробуйте виводити повідомлення за допомогою методу журнал().

Ось і весь загальний огляд класу, далі думаю розберетеся. Для роботи з прикладом необхідно ввести нові дані для підключення до бази. Сам клас я викладаю у файлі, щоб у вас не було помилок при копіюванні, але обов'язково розберіться в роботі до використання.