میلاد به‌تازگی در دیجی‌کالا به‌عنوان توسعه‌دهنده‌ی *junior* استخدام شده است. اولین *task* ای که به او واگذار شده، بازنویسی بخش *pagination* وب‌سایت دیجی‌استایل است. از آن‌جا که میلاد تجربه‌ی انجام این کار را ندارد، از شما می‌خواهیم تا این بخش را برای او پیاده‌سازی کنید.
## ساختار پروژه
پروژه‌ی اوّلیه را از [این‌جا](https://quera.ir/qbox/download/CxDyLpRy1R/pagination-initial.zip) دانلود کنید. ساختار پروژه به‌صورت زیر است:
1. فایل `pagination.tpl`: این فایل شامل قالب *HTML* بخش *pagination* بوده و محتوای آن به‌صورت زیر است:
```html
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" href="assets/css/style.css">
<title>Pagination</title>
</head>
<body>
<main class="container">
<ul class="pagination justify-content-center mt-3">
{{ @pages }}
</ul>
</main>
</body>
</html>
```
2. فایل `pagination.php`: شامل دو تابع زیر است:
+ `renderPagination`: این تابع به‌ترتیب یک رشته حاوی قالب *HTML* ، تعداد مطالب موجود در وب‌سایت، حداکثر تعداد مطالب در هر صفحه، شماره‌ی صفحه‌ی فعلی و لینک پایه‌ی صفحات را دریافت می‌کند. در نهایت، بخش *pagination* را به‌صورت یک رشته برمی‌گرداند.
+ `getPaginationButtons`: این تابع به‌ترتیب تعداد مطالب موجود در وب‌سایت، حداکثر تعداد مطالب در هر صفحه و شماره‌ی صفحه‌ی فعلی را دریافت کرده و آرایه‌ای شامل دکمه‌ها جهت نمایش در بخش *pagination* را برمی‌گرداند. هر دکمه یک آرایه‌ی *associative* است که شامل دو کلید `text` و `number` است. مقدار کلید `text` برای دکمه‌ی رفتن به صفحه‌ی قبلی `prev` و برای دکمه‌ی رفتن به صفحه‌ی بعدی `next` است. هم‌چنین، مقدار کلید `text` برای دکمه‌ی `...` همان `...` است. مقدار کلید `number` بیانگر شماره‌ی صفحه‌ی موجود در لینک دکمه است؛ برای مثال اگر ۴ صفحه داشته باشیم و در حال حاضر در صفحه‌ی ۳ باشیم، مقدار کلید `number` برای دکمه‌های `prev` و `next` به‌ترتیب برابر با `2` و `4` خواهد بود. بدیهی است که مقدار کلید `number` برای سایر دکمه‌ها (به‌جز دکمه‌ی `...`) باید برابر با مقدار کلید `text` باشد.
**توجه:** دکمه‌ی `...` نباید کلید `number` را داشته باشد.
محتویات فایل `pagination.php` به‌صورت زیر است:
```php
<?php
function getPaginationButtons($total_items, $per_page, $current_page)
{
// Implement getPaginationButtons function here
}
function renderPagination($pagination_template, $total_items, $per_page, $current_page, $base_url)
{
$pages = getPaginationButtons($total_items, $per_page, $current_page);
$html = '';
foreach ($pages as $page) {
$page['text'] = str_replace(['prev', 'next'], ['«', '»'], $page['text']);
if (in_array($page['text'], ['«', '...', '»'])) {
$html .= '<li class="page-item">
<a class="page-link" href="' . (isset($page['number']) ? $base_url . $page['number'] : '#') . '">
<span aria-hidden="true">' . $page['text'] . '</span>
</a>
</li>';
} else {
$html .= '<li class="page-item' . ($page['number'] == $current_page ? ' active' : '')
. '"><a class="page-link" href="' . $base_url . $page['number'] . '">'
. $page['number'] . '</a></li>';
}
}
return str_replace('{{ @pages }}', $html, $pagination_template);
}
```
قوانین صفحه‌بندی به‌شرح زیر هستند:
+ صفحات اول و آخر باید از طریق همه‌ی صفحات در دسترس باشند.
+ دو صفحه‌ی قبلی و دو صفحه‌ی بعدی هر صفحه باید در دسترس باشند.
+ صفحاتی که فاصله‌شان از صفحه‌ی فعلی بزرگ‌تر یا مساوی ۳ است با یک دکمه‌ی `...` نمایش داده می‌شوند.
+ اگر فاصله‌ی دو صفحه از یکدیگر ۲ واحد باشد، به جای دکمه‌ی `...` دکمه‌ی شماره‌ی صفحه‌ی بین آن‌ها قرار می‌گیرد؛ برای مثال، بین دکمه‌های ۵ و ۷ هیچ‌گاه دکمه‌ی `...` نمی‌آید.
+ دکمه‌ی `prev` باید در صورتی نمایش داده شود که شماره‌ی صفحه‌ی فعلی ۱ نباشد.
+ دکمه‌ی `next` باید در صورتی نمایش داده شود که شماره‌ی صفحه‌ی فعلی برابر با تعداد صفحات نباشد.
**توجه:** ترتیب آرایه‌های خروجی تابع `getPaginationButtons` باید به‌صورت زیر باشد:
+ دکمه‌ی `prev` (در صورت وجود)
+ دکمه‌ی شماره‌ی صفحات با ترتیب صعودی (می‌تواند شامل دکمه‌ی `...` نیز باشد.)
+ دکمه‌ی `next` (در صورت وجود)
### مثال ۱:
```php
<?php
require 'pagination.php';
getPaginationButtons(56, 5, 7);
/**
[
["text" => "prev", "number" => 6],
["text" => "1", "number" => 1],
["text" => "..."],
["text" => "5", "number" => 5],
["text" => "6", "number" => 6],
["text" => "7", "number" => 7],
["text" => "8", "number" => 8],
["text" => "9", "number" => 9],
["text" => "..."],
["text" => "12", "number" => 12],
["text" => "next", "number" => 8]
]
*/
$pagination_template = file_get_contents('pagination.tpl');
echo renderPagination($pagination_template, 56, 5, 7, 'index.php?page=');
```
خروجی مورد انتظار:
### مثال ۲:
```php
<?php
require 'pagination.php';
getPaginationButtons(14, 4, 1);
/**
[
["text" => "1", "number" => 1],
["text" => "2", "number" => 2],
["text" => "3", "number" => 3],
["text" => "4", "number" => 4],
["text" => "next", "number" => 2]
]
*/
$pagination_template = file_get_contents('pagination.tpl');
echo renderPagination($pagination_template, 14, 4, 1, 'index.php?page=');
```
خروجی مورد انتظار:
### مثال ۳:
```php
<?php
require 'pagination.php';
getPaginationButtons(40, 10, 4);
/**
[
["text" => "prev", "number" => 3],
["text" => "1", "number" => 1],
["text" => "2", "number" => 2],
["text" => "3", "number" => 3],
["text" => "4", "number" => 4]
]
*/
$pagination_template = file_get_contents('pagination.tpl');
echo renderPagination($pagination_template, 40, 10, 4, 'index.php?page=');
```
خروجی مورد انتظار:
### مثال ۴:
```php
<?php
require 'pagination.php';
getPaginationButtons(24, 3, 6);
/**
[
["text" => "prev", "number" => 5],
["text" => "1", "number" => 1],
["text" => "..."],
["text" => "4", "number" => 4],
["text" => "5", "number" => 5],
["text" => "6", "number" => 6],
["text" => "7", "number" => 7],
["text" => "8", "number" => 8],
["text" => "next", "number" => 7]
]
*/
$pagination_template = file_get_contents('pagination.tpl');
echo renderPagination($pagination_template, 24, 3, 6, 'index.php?page=');
```
خروجی مورد انتظار:
### مثال ۵:
```php
<?php
require 'pagination.php';
getPaginationButtons(7, 1, 2);
/**
[
["text" => "prev", "number" => 1],
["text" => "1", "number" => 1],
["text" => "2", "number" => 2],
["text" => "3", "number" => 3],
["text" => "4", "number" => 4],
["text" => "..."],
["text" => "7", "number" => 7],
["text" => "next", "number" => 3]
]
*/
$pagination_template = file_get_contents('pagination.tpl');
echo renderPagination($pagination_template, 7, 1, 2, 'index.php?page=');
```
خروجی مورد انتظار:
3. فایل `index.php`: این فایل توابع موجود در فایل `pagination.php` را فراخوانی کرده و از طریق آن می‌توان خروجی بخش *pagination* را مشاهده کرد. محتوای آن به‌صورت زیر است:
```php
<?php
require 'pagination.php';
$pagination_template = file_get_contents('pagination.tpl');
echo renderPagination($pagination_template, 7 * 5, 5, 2, 'index.php?page=');
```
## آن‌چه باید آپلود کنید
پس از پیاده‌سازی تابع `getPaginationButtons`، فایل `pagination.php` را آپلود کنید.
صفحه‌بندی
میلاد به‌تازگی در دیجی‌کالا به‌عنوان توسعه‌دهنده‌ی junior استخدام شده است. اولین task ای که به او واگذار شده، بازنویسی بخش pagination وب‌سایت دیجی‌استایل است. از آن‌جا که میلاد تجربه‌ی انجام این کار را ندارد، از شما می‌خواهیم تا این بخش را برای او پیاده‌سازی کنید.
ساختار پروژه🔗
پروژه‌ی اوّلیه را از این‌جا دانلود کنید. ساختار پروژه به‌صورت زیر است:
- فایل
pagination.tpl: این فایل شامل قالب HTML بخش pagination بوده و محتوای آن به‌صورت زیر است:
- فایل
pagination.php: شامل دو تابع زیر است:
renderPagination: این تابع به‌ترتیب یک رشته حاوی قالب HTML ، تعداد مطالب موجود در وب‌سایت، حداکثر تعداد مطالب در هر صفحه، شماره‌ی صفحه‌ی فعلی و لینک پایه‌ی صفحات را دریافت می‌کند. در نهایت، بخش pagination را به‌صورت یک رشته برمی‌گرداند.
getPaginationButtons: این تابع به‌ترتیب تعداد مطالب موجود در وب‌سایت، حداکثر تعداد مطالب در هر صفحه و شماره‌ی صفحه‌ی فعلی را دریافت کرده و آرایه‌ای شامل دکمه‌ها جهت نمایش در بخش pagination را برمی‌گرداند. هر دکمه یک آرایه‌ی associative است که شامل دو کلید text و number است. مقدار کلید text برای دکمه‌ی رفتن به صفحه‌ی قبلی prev و برای دکمه‌ی رفتن به صفحه‌ی بعدی next است. هم‌چنین، مقدار کلید text برای دکمه‌ی ... همان ... است. مقدار کلید number بیانگر شماره‌ی صفحه‌ی موجود در لینک دکمه است؛ برای مثال اگر ۴ صفحه داشته باشیم و در حال حاضر در صفحه‌ی ۳ باشیم، مقدار کلید number برای دکمه‌های prev و next به‌ترتیب برابر با 2 و 4 خواهد بود. بدیهی است که مقدار کلید number برای سایر دکمه‌ها (به‌جز دکمه‌ی ...) باید برابر با مقدار کلید text باشد.
توجه: دکمه‌ی ... نباید کلید number را داشته باشد.
محتویات فایل pagination.php به‌صورت زیر است:
قوانین صفحه‌بندی به‌شرح زیر هستند:
- صفحات اول و آخر باید از طریق همه‌ی صفحات در دسترس باشند.
- دو صفحه‌ی قبلی و دو صفحه‌ی بعدی هر صفحه باید در دسترس باشند.
- صفحاتی که فاصله‌شان از صفحه‌ی فعلی بزرگ‌تر یا مساوی ۳ است با یک دکمه‌ی
... نمایش داده می‌شوند.
- اگر فاصله‌ی دو صفحه از یکدیگر ۲ واحد باشد، به جای دکمه‌ی
... دکمه‌ی شماره‌ی صفحه‌ی بین آن‌ها قرار می‌گیرد؛ برای مثال، بین دکمه‌های ۵ و ۷ هیچ‌گاه دکمه‌ی ... نمی‌آید.
- دکمه‌ی
prev باید در صورتی نمایش داده شود که شماره‌ی صفحه‌ی فعلی ۱ نباشد.
- دکمه‌ی
next باید در صورتی نمایش داده شود که شماره‌ی صفحه‌ی فعلی برابر با تعداد صفحات نباشد.
توجه: ترتیب آرایه‌های خروجی تابع getPaginationButtons باید به‌صورت زیر باشد:
- دکمه‌ی
prev (در صورت وجود)
- دکمه‌ی شماره‌ی صفحات با ترتیب صعودی (می‌تواند شامل دکمه‌ی
... نیز باشد.)
- دکمه‌ی
next (در صورت وجود)
مثال ۱:🔗
خروجی مورد انتظار:
مثال ۲:🔗
خروجی مورد انتظار:
مثال ۳:🔗
خروجی مورد انتظار:
مثال ۴:🔗
خروجی مورد انتظار:
مثال ۵:🔗
خروجی مورد انتظار:
- فایل
index.php: این فایل توابع موجود در فایل pagination.php را فراخوانی کرده و از طریق آن می‌توان خروجی بخش pagination را مشاهده کرد. محتوای آن به‌صورت زیر است:
آن‌چه باید آپلود کنید🔗
پس از پیاده‌سازی تابع getPaginationButtons، فایل pagination.php را آپلود کنید.
مهدی طرفدار پروژه‌های خاص و سخت است. اخیراً یکی از دوستان صمیمی او، نیما، سفارش نوشتن یک سایت تبلیغاتی را به او داده است. از آن‌جا که مهدی نمایندگی فروش هاست و سرور ندارد، از نیما درخواست یک هاست برای میزبانی پروژه کرد. نیما هم این درخواست را با کمال میل قبول کرد و دسترسی یک هاست اشتراکی ساده با کم‌ترین امکانات ممکن را برای مهدی فرستاد. مهدی پس از بررسی‌های فراوان، متوجه شد که این هاست حتی قابلیت اتصال به _MySQL_ را هم ندارد! لذا تصمیم گرفت که خودش اطلاعات را در قالب _JSON_ درون فایل‌های مختلف نگه‌داری کند و از آن‌ها استفاده کند.
مهدی فرصت کمی برای انجام این پروژه دارد؛ بنابراین از شما می‌خواهیم که بخش ذخیره‌سازی اطلاعات را برای مهدی بنویسید.
# جزئیات پروژه
ساختار فایل‌هایی که اطلاعات در آن‌ها ذخیره می‌شوند به صورت زیر است:
```
db_files
├── table1.json
├── table2.json
└── table3.json
```
همه‌ی جداول دیتابیس در یک دایرکتوری مشخص قرار می‌گیرند. نام هر فایل، نمایانگر نام جدول است. در مثال بالا، سه جدول با نام‌های `table1`، `table2` و `table3` وجود دارد.
هر جدول شامل خانه‌ای به نام `schema` است و مشخصات مربوط به ستون‌های جدول در آن قرار دارند. در `schema` هر جدول، مقدار پیش‌فرض ستون‌ها و امکان `null` بودن آن‌ها تعریف می‌شود. مقدار پیش‌فرض هر ستون در خانه‌ای به نام `default` و امکان `null` بودن مقدار ستون به صورت `boolean` در خانه‌ای به نام `nullable` ذخیره می‌شود. لزوماً خانه‌ی `default` برای ستون تعریف نمی‌شود، امّا خانه‌ی `nullable` برای تمامی ستون‌ها موجود است.
### مثالی از `schema` یک جدول:
```json
{
"first_name": {
"nullable": false
},
"last_name": {
"nullable": true
},
"country": {
"nullable": true,
"default": "Iran"
}
}
```
هم‌چنین هر جدول خانه‌ای به نام `data` دارد که شامل آرایه‌ای از سطرهای موجود در جدول است.
### مثالی از یک جدول:
```json
{
"schema": {
"first_name": {
"nullable": false
},
"last_name": {
"nullable": true
},
"country": {
"nullable": true,
"default": "Iran"
}
},
"data": [{
"first_name": "John",
"last_name": "Smith",
"country": "U.S."
}, {
"first_name": "Ali",
"last_name": null,
"country": "Iran"
}]
}
```
کل پروژه را در قالب کلاسی به نام `JsonDB` با موارد خواسته‌شده‌ی زیر پیاده‌سازی کنید:
+ متد `__construct` را به گونه‌ای پیاده‌سازی کنید که مسیر اصلی ذخیره‌سازی فایل‌های جداول را دریافت کند. در صورتی که آدرسی به متد داده نشد، مسیر فعلی اسکریپت به‌عنوان مکان ذخیره‌سازی فایل‌های جداول در نظر گرفته می‌شود.
+ متد `insert` را به گونه‌ای پیاده‌سازی کنید که نام جدول و آرایه‌ای از ستون‌های سطر موردنظر را دریافت کرده و آن را به انتهای جدول اضافه کند. در صورتی که مقداری برای ستون خاصی تعریف نشود و مقدار پیش‌فرضی برای آن ستون وجود نداشته باشد و امکان `null` بودن ستون وجود نداشته باشد، باید یک `Exception` با پیام `No value provided for column column_name` (`column_name` نام ستون است) _throw_ شود. در صورتی که مقداری برای ستون خاصی تعریف نشود و مقدار پیش‌فرضی برای آن ستون وجود نداشته باشد و امکان `null` بودن مقدار ستون وجود داشته باشد، مقدار `null` به عنوان مقدار ستون ذخیره خواهد شد. در صورتی که ستونی به متد داده شود و آن ستون در `schema` جدول موجود نباشد، باید یک `Exception` با پیام `Column column_name not found` (`column_name` نام ستون موردنظر است) _throw_ شود.
### مثالی از فراخوانی متد `insert`:
```php
$db = new JsonDB(__DIR__ . '/db');
$db->insert('users', ['first_name' => 'Ali', 'last_name' => 'AliZadeh', 'country' => 'Iran']);
$db->insert('users', ['first_name' => 'Ali', 'last_name' => 'AliZadeh']);
$db->insert('users', ['last_name' => 'AliZadeh', 'country' => 'Iran']); // Exception: No value provided for column first_name
```
+ متد `select` را به گونه‌ای پیاده‌سازی کنید که نام جدول و آرایه‌ای از ستون‌ها و مقادیر متناظرشان را دریافت کرده و سطرهایی که مقادیر ستون‌هایشان با مقادیر ستون‌های ورودی یکسان است را در قالب آرایه برگرداند. لزوماً مقادیر همه‌ی ستون‌ها به‌عنوان ورودی به متد داده نمی‌شوند. فرض بر این است که بین شرط‌ها جهت یافتن سطرهای خروجی `AND` وجود دارد. در صورتی که ستونی به‌عنوان ورودی به متد داده نشود، باید همه‌ی سطرها به‌عنوان خروجی تابع `return` شود. در صورتی که ستونی به متد داده شود و آن ستون در `schema` جدول موجود نباشد، باید یک `Exception` با پیام `Column column_name not found` (`column_name` نام ستون موردنظر است) _throw_ شود.
### مثالی از فراخوانی متد `select`:
```php
$db = new JsonDB(__DIR__ . '/db');
$db->select('users');
/*
[
[
'first_name' => 'Ali',
'last_name' => 'AliZadeh',
'country' => 'Iran'
],
[
'first_name' => 'John',
'last_name' => 'Smith',
'country' => null
]
]
*/
$db->select('users', ['first_name' => 'Ali']);
/*
[
[
'first_name' => 'Ali',
'last_name' => 'AliZadeh',
'country' => 'Iran'
]
]
*/
$db->select('users', ['first_name' => 'Ali', 'country' => null]);
/*
[]
*/
$db->insert('users', ['invalid_column' => 'Sample Value', 'country' => 'Iran']); // Exception: Column invalid_column not found
```
+ متد `update` مقدار یک یا چند ستون را در سطرهایی که مشخص می‌کنیم تغییر می‌دهد. این متد شامل سه آرگومان بوده که آرگومان اول نام جدول موردنظر برای به‌روزرسانی است، آرگومان دوم شامل مقادیر جدید ستون‌هایی است که قرار است تغییر کنند و آرگومان سوم مشخص می‌کند که ستون‌های چه سطرهایی باید تغییر کنند؛ به طوری که هر سطری که مقادیر ستون‌هایش برابر با مقادیر ستون‌های آرگومان سوم باشد باید به‌روزرسانی شود. لزوماً مقادیر همه‌ی ستون‌های جدول در آرگومان‌های دوم و سوّم موجود نیستند. اگر آرگومان سوّم به متد داده نشد، باید همه‌ی سطرهای جدول به‌روزرسانی شوند. فرض بر این است که بین شرط‌ها جهت یافتن سطرها جهت به‌روزرسانی `AND` وجود دارد. در صورتی که ستونی در آرگومان دوم یا سوّم موجود باشد و آن ستون در `schema` جدول موجود نباشد، باید یک `Exception` با پیام `Column column_name not found` (`column_name` نام ستون موردنظر است) _throw_ شود.
### مثالی از فراخوانی متد `update`:
```php
$db = new JsonDB(__DIR__ . '/db');
$db->select('users');
/*
[
[
'first_name' => 'Ali',
'last_name' => 'AliZadeh',
'country' => 'Iran'
],
[
'first_name' => 'John',
'last_name' => 'Smith',
'country' => null
]
]
*/
$db->update('users', ['first_name' => 'Mohammad'], ['first_name' => 'Ali']);
$db->select('users');
/*
[
[
'first_name' => 'Mohammad',
'last_name' => 'AliZadeh',
'country' => 'Iran'
],
[
'first_name' => 'John',
'last_name' => 'Smith',
'country' => null
]
]
*/
$db->update('users', ['first_name' => 'Mohammad']);
$db->select('users');
/*
[
[
'first_name' => 'Mohammad',
'last_name' => 'AliZadeh',
'country' => 'Iran'
],
[
'first_name' => 'Mohammad',
'last_name' => 'Smith',
'country' => null
]
]
*/
$db->update('users', ['invalid_column' => 'Test']); // Exception: Column invalid_column not found
```
+ متد `delete` را به گونه‌ای پیاده‌سازی کنید که نام جدول و آرایه‌ای از ستون‌ها و مقادیر متناظرشان را دریافت کرده و سطرهایی که مقادیر ستون‌هایشان با مقادیر ستون‌های ورودی یکسان است را از جدول حذف کند. لزوماً مقادیر همه‌ی ستون‌ها به‌عنوان ورودی به متد داده نمی‌شوند. فرض بر این است که بین شرط‌ها جهت یافتن سطرها برای حذف `AND` وجود دارد. در صورتی که ستونی به‌عنوان ورودی به متد داده نشود، باید همه‌ی سطرها از جدول حذف شوند. در صورتی که ستونی به متد داده شود و آن ستون در `schema` جدول موجود نباشد، باید یک `Exception` با پیام `Column column_name not found` (`column_name` نام ستون موردنظر است) _throw_ شود.
### مثالی از فراخوانی متد `delete`:
```php
$db = new JsonDB(__DIR__ . '/db');
$db->select('users');
/*
[
[
'first_name' => 'Ali',
'last_name' => 'AliZadeh',
'country' => 'Iran'
],
[
'first_name' => 'John',
'last_name' => 'Smith',
'country' => null
]
]
*/
$db->delete('users', ['first_name' => 'Mohammad']);
$db->select('users');
/*
[
[
'first_name' => 'Ali',
'last_name' => 'AliZadeh',
'country' => 'Iran'
],
[
'first_name' => 'John',
'last_name' => 'Smith',
'country' => null
]
]
*/
$db->delete('users', ['first_name' => 'Ali']);
$db->select('users');
/*
[
[
'first_name' => 'John',
'last_name' => 'Smith',
'country' => null
]
]
*/
$db->delete('users');
$db->select('users');
/*
[]
*/
$db->delete('users', ['invalid_column' => 'Test']); // Exception: Column invalid_column not found
```
**نکته:** در صورتی که جدول موردنظر در هر یک از متدهای `insert`، `select`، `update` یا `delete` یافت نشود، باید یک `Exception` با پیام `Table table_name not found` (`table_name` نام جدول موردنظر است) _throw_ شود.
## آن‌چه باید آپلود کنید
یک فایل _PHP_ که کلاس `JsonDB` درون آن قرار دارد آپلود کنید.
پسر J
مهدی طرفدار پروژه‌های خاص و سخت است. اخیراً یکی از دوستان صمیمی او، نیما، سفارش نوشتن یک سایت تبلیغاتی را به او داده است. از آن‌جا که مهدی نمایندگی فروش هاست و سرور ندارد، از نیما درخواست یک هاست برای میزبانی پروژه کرد. نیما هم این درخواست را با کمال میل قبول کرد و دسترسی یک هاست اشتراکی ساده با کم‌ترین امکانات ممکن را برای مهدی فرستاد. مهدی پس از بررسی‌های فراوان، متوجه شد که این هاست حتی قابلیت اتصال به MySQL را هم ندارد! لذا تصمیم گرفت که خودش اطلاعات را در قالب JSON درون فایل‌های مختلف نگه‌داری کند و از آن‌ها استفاده کند.
مهدی فرصت کمی برای انجام این پروژه دارد؛ بنابراین از شما می‌خواهیم که بخش ذخیره‌سازی اطلاعات را برای مهدی بنویسید.
جزئیات پروژه🔗
ساختار فایل‌هایی که اطلاعات در آن‌ها ذخیره می‌شوند به صورت زیر است:
همه‌ی جداول دیتابیس در یک دایرکتوری مشخص قرار می‌گیرند. نام هر فایل، نمایانگر نام جدول است. در مثال بالا، سه جدول با نام‌های table1، table2 و table3 وجود دارد.
هر جدول شامل خانه‌ای به نام schema است و مشخصات مربوط به ستون‌های جدول در آن قرار دارند. در schema هر جدول، مقدار پیش‌فرض ستون‌ها و امکان null بودن آن‌ها تعریف می‌شود. مقدار پیش‌فرض هر ستون در خانه‌ای به نام default و امکان null بودن مقدار ستون به صورت boolean در خانه‌ای به نام nullable ذخیره می‌شود. لزوماً خانه‌ی default برای ستون تعریف نمی‌شود، امّا خانه‌ی nullable برای تمامی ستون‌ها موجود است.
مثالی از schema یک جدول:🔗
هم‌چنین هر جدول خانه‌ای به نام data دارد که شامل آرایه‌ای از سطرهای موجود در جدول است.
مثالی از یک جدول:🔗
کل پروژه را در قالب کلاسی به نام JsonDB با موارد خواسته‌شده‌ی زیر پیاده‌سازی کنید:
متد __construct را به گونه‌ای پیاده‌سازی کنید که مسیر اصلی ذخیره‌سازی فایل‌های جداول را دریافت کند. در صورتی که آدرسی به متد داده نشد، مسیر فعلی اسکریپت به‌عنوان مکان ذخیره‌سازی فایل‌های جداول در نظر گرفته می‌شود.
متد insert را به گونه‌ای پیاده‌سازی کنید که نام جدول و آرایه‌ای از ستون‌های سطر موردنظر را دریافت کرده و آن را به انتهای جدول اضافه کند. در صورتی که مقداری برای ستون خاصی تعریف نشود و مقدار پیش‌فرضی برای آن ستون وجود نداشته باشد و امکان null بودن ستون وجود نداشته باشد، باید یک Exception با پیام No value provided for column column_name (column_name نام ستون است) throw شود. در صورتی که مقداری برای ستون خاصی تعریف نشود و مقدار پیش‌فرضی برای آن ستون وجود نداشته باشد و امکان null بودن مقدار ستون وجود داشته باشد، مقدار null به عنوان مقدار ستون ذخیره خواهد شد. در صورتی که ستونی به متد داده شود و آن ستون در schema جدول موجود نباشد، باید یک Exception با پیام Column column_name not found (column_name نام ستون موردنظر است) throw شود.
مثالی از فراخوانی متد insert:🔗
- متد
select را به گونه‌ای پیاده‌سازی کنید که نام جدول و آرایه‌ای از ستون‌ها و مقادیر متناظرشان را دریافت کرده و سطرهایی که مقادیر ستون‌هایشان با مقادیر ستون‌های ورودی یکسان است را در قالب آرایه برگرداند. لزوماً مقادیر همه‌ی ستون‌ها به‌عنوان ورودی به متد داده نمی‌شوند. فرض بر این است که بین شرط‌ها جهت یافتن سطرهای خروجی AND وجود دارد. در صورتی که ستونی به‌عنوان ورودی به متد داده نشود، باید همه‌ی سطرها به‌عنوان خروجی تابع return شود. در صورتی که ستونی به متد داده شود و آن ستون در schema جدول موجود نباشد، باید یک Exception با پیام Column column_name not found (column_name نام ستون موردنظر است) throw شود.
مثالی از فراخوانی متد select:🔗
- متد
update مقدار یک یا چند ستون را در سطرهایی که مشخص می‌کنیم تغییر می‌دهد. این متد شامل سه آرگومان بوده که آرگومان اول نام جدول موردنظر برای به‌روزرسانی است، آرگومان دوم شامل مقادیر جدید ستون‌هایی است که قرار است تغییر کنند و آرگومان سوم مشخص می‌کند که ستون‌های چه سطرهایی باید تغییر کنند؛ به طوری که هر سطری که مقادیر ستون‌هایش برابر با مقادیر ستون‌های آرگومان سوم باشد باید به‌روزرسانی شود. لزوماً مقادیر همه‌ی ستون‌های جدول در آرگومان‌های دوم و سوّم موجود نیستند. اگر آرگومان سوّم به متد داده نشد، باید همه‌ی سطرهای جدول به‌روزرسانی شوند. فرض بر این است که بین شرط‌ها جهت یافتن سطرها جهت به‌روزرسانی AND وجود دارد. در صورتی که ستونی در آرگومان دوم یا سوّم موجود باشد و آن ستون در schema جدول موجود نباشد، باید یک Exception با پیام Column column_name not found (column_name نام ستون موردنظر است) throw شود.
مثالی از فراخوانی متد update:🔗
- متد
delete را به گونه‌ای پیاده‌سازی کنید که نام جدول و آرایه‌ای از ستون‌ها و مقادیر متناظرشان را دریافت کرده و سطرهایی که مقادیر ستون‌هایشان با مقادیر ستون‌های ورودی یکسان است را از جدول حذف کند. لزوماً مقادیر همه‌ی ستون‌ها به‌عنوان ورودی به متد داده نمی‌شوند. فرض بر این است که بین شرط‌ها جهت یافتن سطرها برای حذف AND وجود دارد. در صورتی که ستونی به‌عنوان ورودی به متد داده نشود، باید همه‌ی سطرها از جدول حذف شوند. در صورتی که ستونی به متد داده شود و آن ستون در schema جدول موجود نباشد، باید یک Exception با پیام Column column_name not found (column_name نام ستون موردنظر است) throw شود.
مثالی از فراخوانی متد delete:🔗
نکته: در صورتی که جدول موردنظر در هر یک از متدهای insert، select، update یا delete یافت نشود، باید یک Exception با پیام Table table_name not found (table_name نام جدول موردنظر است) throw شود.
آن‌چه باید آپلود کنید🔗
یک فایل PHP که کلاس JsonDB درون آن قرار دارد آپلود کنید.
