🕧 👜 💯 CleverStyle CMS पर एक साधारण ब्लॉग विकसित करने का एक उदाहरण 🍡 🧀 ☝🏼

ध्यान दें: लेख लेखन के समय प्रासंगिक है, चीजों की वर्तमान स्थिति पूरी तरह से थोड़ा कम भिन्न हो सकती है।

मैं लंबे समय से सोच रहा था कि आधुनिक ढांचे कैसे विकास को जटिल बनाते हैं। बेशक, मुझे यह कहने का कोई अधिकार नहीं है कि वे बुरे हैं, लेकिन मैं उन्हें अच्छा नहीं कह सकता। और इसीलिए: उनका लक्ष्य विकास को सरल बनाना और गति प्रदान करना है, साथ ही किसी तरह परियोजना का मानकीकरण और संरचना करना है। लेकिन, मेरी विनम्र व्यक्तिपरक राय में, पहली छमाही के साथ कभी-कभी विपरीत प्रभाव प्राप्त होता है, बहुत सारे कोड लिखे जाते हैं जो खुद से कुछ भी नहीं करता है, लेकिन केवल मुख्य कोड का कार्य करता है। यह आलेख एक सरल ब्लॉग को विकसित करने के कार्य के लिए एक अलग दृष्टिकोण का एक उदाहरण है, न कि Zend फ्रेमवर्क 2 का उपयोग करते हुए, जैसा कि rrromka ने किया था , लेकिन क्लीवरसाइल CMS के स्वयं के विकास।

थोड़ा इतिहास

मैं 3 साल के लिए क्लेवरसेल सीएमएस विकसित कर रहा हूं। जरूरत सिर्फ उस जटिलता और असुविधा के कारण पैदा हुई जो मैं काम करने की कोशिश कर रहा था। विकास खाली समय में किया जाता है, साथ ही साथ सीएमएस का उपयोग करने वाली परियोजनाओं के साथ समानांतर में (कार्यक्षमता जो गायब है, जोड़ा जाता है)। इसका मतलब यह है कि वास्तव में आवश्यक कार्यों को जोड़ा जाता है, जिसके लिए कार्य हैं, और यह भी कि जिस रूप में वे उपयोग करने के लिए सबसे सुविधाजनक होंगे। मुख्य विचार स्पष्ट चीजों के काम को स्वचालित बनाना है, और बिल्कुल स्पष्ट नहीं है - बेहद सरल, जबकि हमेशा मानक व्यवहार को प्रभावित करने और किसी भी तरह से इसे समायोजित करने का अवसर होता है। खैर, पिछले लेख की रचनात्मक आलोचना के लिए सबसे बड़ी कृतज्ञता के लिए अंतिम आभार है: आपने मुझे कुछ चीजों पर अपने विचारों पर पुनर्विचार करने में मदद की, एक बेहतर प्रोग्रामर बनें और बेहतर के लिए क्लीवरसेल सीएमएस को बदलें।

पर्यावरण

जाहिर है, हमें एक्सेस विवरण के साथ एक वेब सर्वर और एक डेटाबेस की आवश्यकता है।
स्थापना के लिए, आपको संगीतकार या किसी अन्य उपकरण की आवश्यकता नहीं है, आपको अभिलेखागार का उपयोग करने की भी आवश्यकता नहीं है। वितरण को भविष्य की साइट की जड़ में फेंक दें और इसे ब्राउज़र के माध्यम से खोलें। आपको यह विंडो मिलती है:

सभी क्षेत्रों को भरने से, आपको उपयोग के लिए तैयार वातावरण मिलता है। वितरण पैकेज स्वयं को अनपैक करेगा, जहां डिफ़ॉल्ट सेटिंग्स सेट करें जहां आवश्यक हो और सुरक्षा उद्देश्यों के लिए स्वयं को हटा दें। पहले से ही इस चरण से आप सादगी देख सकते हैं, आपको ftp / ssh के माध्यम से कई दसियों हज़ारों छोटी फ़ाइलों को कॉपी करने की आवश्यकता नहीं है।

भविष्य के मॉड्यूल की संरचना

आप विकी में सिस्टम की संरचना से परिचित हो सकते हैं, लेकिन हम लेख के पाठ्यक्रम में उपयोग किए गए भागों से परिचित होंगे।
मॉड्यूल में स्वयं पोस्ट वर्ग शामिल होगा, जो डेटाबेस पर एक आवरण होगा और पदों को प्रबंधित करने के लिए एक सरल इंटरफ़ेस प्रदान करेगा। उपयोगकर्ता, एपीआई के लिए उपलब्ध वास्तविक पृष्ठ भी होंगे, और अंत में कई मेटा फाइलें होंगी जो इंजन को काम के कुछ विवरणों की व्याख्या करेंगी और मॉड्यूल को स्व-वितरित वितरण में इकट्ठा करने की अनुमति देंगी।
सबसे पहले, हमारे भविष्य के मॉड्यूल के लिए घटक / मॉड्यूल / MyBlog निर्देशिका बनाएं।

डीबी

एक ब्लॉग पोस्ट में एक शीर्षक, सामग्री, लेखक और लेखन की तारीख होगी। चित्रमय साधनों के पालन के रूप में, मैं PhpMyAdmin और निर्यात में संरचना तैयार करता हूं:

CREATE TABLE IF NOT EXISTS `[prefix]myblog_posts` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `user` int(10) unsigned NOT NULL, `title` varchar(1024) NOT NULL, `text` text NOT NULL, `date` bigint(20) unsigned NOT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8;

तालिका उपसर्ग को बहुमुखी प्रतिभा के लिए [prefix] से बदल दिया गया है, सीएमएस इसके बजाय आवश्यक एक को प्रतिस्थापित करेगा।
हम फ़ाइल घटक / मॉड्यूल / MyBlog / मेटा / install_db / पोस्ट / MySQLi.sql बनाते हैं और प्राप्त SQL को वहां चिपकाते हैं। इस प्रकार, व्यवस्थापक पैनल में मॉड्यूल स्थापित करते समय, डेटाबेस में आवश्यक तालिका बनाई जाएगी। इसी तरह, फ़ाइल घटक / मॉड्यूल / MyBlog / मेटा / uninstall_db / पोस्ट / MySQLi.sql बनाएँ :

 DROP TABLE `[prefix]myblog_posts`;

MySQLi डेटाबेस इंजन का नाम है, यह अभी तक केवल एक ही है,
पोस्ट एक मनमाना नाम है जिसके साथ डेटाबेस जुड़ा हुआ है (यह विभिन्न उद्देश्यों के लिए कई हो सकता है, इस बिंदु तक कि टेबल का हिस्सा MySQL / MariaDB में एक सर्वर पर होगा और दूसरा PostgreSQL में दूसरे सर्वर पर होगा)।
हमें घटकों / मॉड्यूल / MyBlog / मेटा / db.json में नाम पोस्ट लिखने दें:

 [ "posts" ]

डेटाबेस के साथ यह सब है। मॉड्यूल को हटाए जाने पर मॉड्यूल स्थापित और हटाए जाने पर तालिका बनाई जाएगी।

डाक वर्ग

हम कक्षा को घटकों / मॉड्यूल / MyBlog / Posts.php फ़ाइल में रखते हैं और इसे cs \ मॉड्यूल \ MyBlog नामस्थान में डालते हैं - इससे सीएमएस को यदि आवश्यक हो तो इसे खोजने की अनुमति मिलेगी।

छिपा हुआ पाठ

 <?php /** * @package MyBlog * @category modules * @author Nazar Mokrynskyi <nazar@mokrynskyi.com> * @copyright Copyright (c) 2013, Nazar Mokrynskyi * @license MIT License, see license.txt */ namespace cs\modules\MyBlog; use cs\Config, cs\Cache\Prefix, cs\DB\Accessor, cs\Language, cs\User, cs\CRUD, cs\Singleton; /** * Class Posts for posts manipulation * * @method static \cs\modules\MyBlog\Posts instance($check = false) */ class Posts { use CRUD, Singleton; /** * Cache object instance * * @var Prefix */ protected $cache; protected $table = '[prefix]myblog_posts'; protected $data_model = [ 'id' => 'int', 'user' => 'int', 'title' => 'text', 'text' => 'html', 'date' => 'int' ]; protected function construct () { /** * Save instance of cache object with prefix MyBlog (will be added to every item) */ $this->cache = new Prefix('MyBlog'); } /** * Required by abstract Accessor class * * @return int Database index */ protected function cdb () { return Config::instance()->module('MyBlog')->db('posts'); } /** * Get post * * @param int|int[] $id * * @return array|bool */ function get ($id) { if (is_array($id)) { foreach ($id as &$i) { $i = $this->get($i); } return $id; } $id = (int)$id; /** * Try to get item from cache, if not found - get it from database and save in cache */ return $this->cache->get("posts/$id", function () use ($id) { $data = $this->read_simple($id); if ($data) { $L = Language::instance(); $data['datetime'] = $L->to_locale(date($L->_datetime_long, $data['date'])); $data['username'] = User::instance()->username($data['user']); } return $data; }); } /** * Add post * * @param string $title * @param string $text * * @return bool|int Id of created post or <b>false</b> on failure */ function add ($title, $text) { $id = $this->create_simple([ User::instance()->id, $title, $text, TIME ]); if ($id) { /** * Delete total count of posts */ unset($this->cache->total_count); return $this->db_prime()->id(); } return false; } /** * Edit post * * @param int $id * @param string $title * @param string $text * * @return bool */ function set ($id, $title, $text) { $data = $this->get($id); $data['title'] = $title; $data['text'] = $text; if ($this->update_simple($data)) { /** * Delete cached item if any */ unset($this->cache->{"posts/$id"}); return true; } return false; } /** * Delete post * * @param int $id * * @return bool */ function del ($id) { if ($this->delete_simple($id)) { /** * Delete cached item if any, and total count of posts */ unset( $this->cache->{"posts/$id"}, $this->cache->total_count ); return true; } return false; } /** * Get posts * * @param $page * * @return int[] */ function posts ($page = 1) { $from = ($page - 1) * 10 ?: 0; return $this->db()->qfas( //Readable database, Query, Fetch, Single, Array "SELECT `id` FROM `[prefix]myblog_posts` ORDER BY `id` DESC LIMIT $from, 10" ) ?: []; } /** * Get total count of posts * * @return int */ function total_count () { return $this->cache->get('total_count', function () { return $this->db()->qfs( //Readable database, Query, Fetch, Single "SELECT COUNT(`id`) FROM `[prefix]myblog_posts`" ) ?: 0; }); } }

वर्ग पदों के कैशिंग और उनकी कुल संख्या के साथ डेटाबेस पर एक आवरण है। यह एक अकेला वर्ग है, और इन सार्वजनिक तरीके हैं:

प्राप्त
जोड़ना
सेट
डेल
पदों
TOTAL_COUNT

वर्ग स्वयं एक्सेस अधिकारों की जांच नहीं करता है, लेकिन केवल दर्ज किए गए डेटा की शुद्धता।

DB का उपयोग रीड मोड और राइट मोड दोनों में किया जाता है

इस उदाहरण में, यह महत्वपूर्ण नहीं है, लेकिन संचालन के प्रारंभिक अलगाव लेखन के लिए मुख्य डेटाबेस का उपयोग करने और बाकी पढ़ने के लिए प्रतिकृति का उपयोग करने की अनुमति देगा; यह छोटा सा पृथक्करण संभावना के साथ किया जाता है

कोड काफी सरल लिखा है और अच्छी तरह से टिप्पणी की है, और आईडीई भी उठाता है।

उपयोगकर्ता इंटरफ़ेस

सामान्य तौर पर, राउटिंग के लिए एक सरल जसन संरचना का उपयोग किया जाता है, जो मॉड्यूल के अंदर पृष्ठों के पते का वर्णन करता है। एक फ़ाइल घटक / मॉड्यूल / MyBlog / index.json बनाएँ जो उपयोगकर्ता के भाग के मार्ग का वर्णन करता है:

 { "list" : [], "post" : [ "view", "add", "edit", "delete" ] }

इस प्रकार, रास्ते इस तरह दिखेंगे:

Myblog / सूची
Myblog / सूची / {पृष्ठ}
Myblog / पोस्ट / जोड़ें
MyBlog / पोस्ट / देखने / {आईडी}

तदनुसार, मॉड्यूल निर्देशिका में हम निम्नलिखित फ़ाइल संरचना बनाते हैं:

list.php
पोस्ट / add.php
पोस्ट / हटाएं
पोस्ट / edit.php
post / view.php

इस तथ्य के कारण कि वे ऊपर वर्णित हैं - सीएमएस उन्हें संबंधित पृष्ठों पर बुलाएगा।
उदाहरण list.php फ़ाइल:

छिपा हुआ पाठ

 namespace cs\modules\MyBlog; use cs\Config, cs\Page, h; $rc = Config::instance()->route; $page = 1; if (isset($rc[1]) && $rc[1]) { $page = (int)$rc[1]; } $Page = Page::instance(); $Posts = Posts::instance(); $total_count = $Posts->total_count(); $Page->content( h::{'a.cs-button-compact'}( h::icon('plus').'  ', [ 'href' => 'MyBlog/post/add' ] ) ); if (!$total_count) { $Page->content( h::{'p.cs-center.uk-text-info'}('  ') ); return; } $Page->title(' '); if ($page > 1) { $Page->title(" $page"); } $Page->content( h::{'section article.cs-myblog-posts'}( h::{'h1 a[href=MyBlog/post/$i[id]]'}('$i[title]'). h::div('$i[text]'). h::footer('$i[datetime], $i[username]'), [ 'insert' => $Posts->get($Posts->posts($page)) ] ). ( $total_count > 10 ? h::{'div.cs-center'}(pages($page, ceil($total_count / 10), function ($page) { return $page < 2 ? 'MyBlog' : "MyBlog/list/$page"; })) : '' ) );

लगभग सभी मॉड्यूल फ़ाइलों में नाम स्थान समान है।
Config::instance()->route - आपको मॉड्यूल नाम पर विचार किए बिना पृष्ठ पथ तत्वों की एक अनुक्रमित सरणी प्राप्त करने की अनुमति देता है। इस स्थिति में, यह निर्धारित करने के लिए उपयोग किया जाता है कि उपयोगकर्ता किस पृष्ठ पर खुलता है, उदाहरण के लिए, MyBlog/list/3 हमें एक सरणी मिलती है ['list', 3] । सामान्य तौर पर, ऊपर बताई गई फाइलें प्रतिनिधित्व + पहुंच नियंत्रण हैं।

एपीआई

हां, हम मॉड्यूल में बाहरी एपीआई का उपयोग नहीं करेंगे, लेकिन फिर भी हम इसे करेंगे (यह किसी के लिए उपयोगी हो सकता है)। चलो सबसे सरल काम करते हैं - विशिष्ट पदों का प्रबंधन (उदाहरण के लिए, पृष्ठ को फिर से लोड किए बिना पदों को संपादित करने के लिए)। घटकों / मॉड्यूल / MyBlog / एपीआई में कई फाइलें बनाएँ:

index.delete.php
index.get.php
index.post.php
index.put.php

मुझे लगता है कि फाइलों के नाम अपने बारे में पर्याप्त बताते हैं। सरलतम स्थिति में, हमारे पास कोई संरचना नहीं है और हमें index.json की आवश्यकता नहीं है - हम सिर्फ DELETE / GET / POST / PUT के प्रत्येक प्रकार के लिए अनुक्रमणिका फ़ाइलों का एक समूह बनाते हैं और CMS को ये फ़ाइलें स्वयं मिलेंगी। अनुक्रमणिका के साथ नेस्टेड संरचना के साथ एपीआई में सफ़िक्स का उपयोग इसी तरह से किया जा सकता है। उदाहरण API अनुरोध:

पोस्ट Api / MyBlog
{
"शीर्षक": "ब्लॉग पोस्ट शीर्षक",
"पाठ": "ब्लॉग पोस्ट सामग्री"
}

आप JSON भेज सकते हैं यदि आप सामग्री-प्रकार: एप्लिकेशन / json निर्दिष्ट करना न भूलें।
प्रतिक्रिया में, या तो:

201 बनाया
...
{
"Id": "5"
}

या एक कोड और एक त्रुटि संदेश।
यहाँ index.post.php फ़ाइल है जो ऐसा करती है:

 namespace cs\modules\MyBlog; use cs\Page; if (!isset($_POST['title'], $_POST['text'])) { error_code(400); return; } if ($post = Posts::instance()->add($_POST['title'], $_POST['text'])) { code_header(201); Page::instance()->json([ 'id' => $post ]); } else { error_code(500); }

Page::instance()->json() आपको डेटा भेजने की अनुमति देता है जैसा कि यह है (उदाहरण के लिए, सरणियाँ), और विधि स्वयं एक JSON स्ट्रिंग बनायेगी और आवश्यक हेडर जोड़ेगी। वही error_code() लिए जाता है, बस त्रुटि कोड पास करें - बाकी सब कुछ अपने आप हो जाएगा।

अंत में

हमारे मॉड्यूल के इंस्टालेशन डिस्ट्रीब्यूशन को बनाने के लिए, कुछ सर्विस जानकारी के साथ फाइल कंपोनेंट्स / मॉड्यूल / MyBlog / meta.json बनाएँ :

 { "package" : "MyBlog", "category" : "modules", "version" : "0.0.2", "description" : "Simple demo blog module", "author" : "Nazar Mokrynskyi", "website" : "cleverstyle.org/cms", "license" : "MIT License", "db_support" : [ "MySQLi" ], "provide" : "myblog", "optional" : [ "editor" ], "languages" : [ "" ] }

जैसा कि अपेक्षित है - पोस्ट पृष्ठ के शीर्षक को सुंदर बनाने और नाम को स्थानीय बनाने के लिए घटकों / मॉड्यूल / MyBlog / lic.txt , साथ ही घटकों / मॉड्यूल / MyBlog / तैयार . php और घटकों / मॉड्यूल / MyBlog / भाषा / रूसी.जोन जोड़ें । मॉड्यूल।
ठीक है, जब सब कुछ तैयार हो जाता है - हम क्लीवरसेल सीएमएस रिपॉजिटरी से लेते हैं और इसे साइट की जड़ में जोड़ते हैं:

निर्माण
स्थापित
build.php
install.php

कुछ पंक्तियों को .htaccess में जोड़ें (ताकि इंजन इस फ़ाइल में कॉल को इंटरसेप्ट न करे):

<फ़ाइलें build.php>
रेवेरिटेंगिन बंद
</ फ़ाइलें>

build.php जाएं, मॉड्यूल का चयन करें, सूची में build.php चुनें, बिल्ड पर क्लिक करें।
साइट की जड़ में हमें फ़ाइल MyBlog_0.0.2.phar.php , जिसका उपयोग सिस्टम की दूसरी प्रति पर स्थापित करने के लिए किया जा सकता है।

और क्या किया जा सकता है

यदि आपको पोस्ट स्टाइलिंग की आवश्यकता है:

घटक / मॉड्यूल / MyBlog / / .htaccess शामिल करें
सभी से अनुमति दें
रेवेरिटेंगिन बंद
घटकों / मॉड्यूल / MyBlog / शामिल / css में आवश्यक शैली की फाइलें डालें, सिस्टम उन्हें उठाएगा (घटकों / मॉड्यूल / जावास्क्रिप्ट में जावास्क्रिप्ट के समान / js) और
प्रक्रिया करेंगे
उत्पादन में फ़ाइलें gzip का उपयोग करके संयुक्त और संपीड़ित होती हैं, और टिप्पणियां अतिरिक्त रूप से css फ़ाइलों में साफ़ की जाती हैं, और आयात जैसे css शैलियाँ, फ़ॉन्ट, चित्र एम्बेड किए जाते हैं, इसलिए सब कुछ एक फ़ाइल में है

इस लेख के लिए एक विशेष परीक्षण भंडार बनाया गया है ।
मुझे उम्मीद है कि इस दृष्टिकोण के साथ, जब कम से कम कोड का उपयोग किया जाता है और संरचना कहीं अधिक सरल है, न केवल मुझसे अपील करेगा।
आपके ध्यान के लिए धन्यवाद, मुझे सवालों और रचनात्मक आलोचना पर खुशी होगी।

UPD युगल स्क्रीनशॉट:

छिपा हुआ पाठ

UPD 11.11.2013: CRUD विशेषता इंजन के नए संस्करण में दिखाई दी है, पोस्ट वर्ग संपादित किया गया है, और इसका उपयोग करना आसान हो गया है।

CleverStyle CMS पर एक साधारण ब्लॉग विकसित करने का एक उदाहरण

थोड़ा इतिहास

पर्यावरण

भविष्य के मॉड्यूल की संरचना

डीबी

डाक वर्ग

उपयोगकर्ता इंटरफ़ेस

एपीआई

अंत में

और क्या किया जा सकता है

More articles: