Skip to content

Commit 2e7a885

Browse files
Update README.md
1 parent 2a455ea commit 2e7a885

File tree

1 file changed

+92
-1
lines changed

1 file changed

+92
-1
lines changed

README.md

+92-1
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,95 @@ simple mvc rest api in php
33

44
# آموزش استفاده از این وب سرویس
55

6-
به زودی
6+
<p lang="fa" dir="rtl" align="right"> با سلام خدمت دوستان و همشهریان عزیز کشور عزیزم <b> افغانستان </b>
7+
من محمد رحمانی هستم. یک برنامه نویس در حوضه وب. رزومه من رو میتوانید در وب سایت من به نشانی http://mohammadrahmani.com ببینید.</p>
8+
9+
<p lang="fa" dir="rtl" align="right"><b>خب قصد دارم استفاده از این وب سرویس رو در ادامه به شما آموزش بدم اگر سوالی هم داشتید میتونید از طریق وب سایتم با من در ارتباط باشید </b></p>
10+
11+
<h2 lang="fa" dir="rtl" align="right"> وب سرویس (REST API) چیه؟</h2>
12+
<p lang="fa" dir="rtl" align="right"> اونایی که تجربه کار با Api رو دارن خب میدونن چیه ولی اونایی که نمیدونن. </p>
13+
<p lang="fa" dir="rtl" align="right"> اگر از اپلیکیشن های مثلا فیسبوک یا توییتر یا هر اپلیکیشن دیگه ای در گوشیتون استفاده کرده باشید. این اپلیکیشن ها نیاز دارن تا با اینترنت در ارتباط باشن و اطلاعاتی رو از وب سایت مشخصی دریافت و ارسال کنند. </p>
14+
15+
<p lang="fa" dir="rtl" align="right"><b> به زبون ساده تر میشه گفت وب سرویس زبان ارتباطی بین یک وب سایت و اپلیکیشن هست.</b></p>
16+
17+
<p lang="fa" dir="rtl" align="right"> وارد مسائل پیچیده نمیشیم اگر میخایید کامل یاد بگیرید توی گوگل جستجو کنید. </p>
18+
19+
<h2 lang="fa" dir="rtl" align="right"> اضافه کردن Route جدید</h2>
20+
<p lang="fa" dir="rtl" align="right"> برای این کار فایل Router.php رو از پوشه Router باز کنید </p>
21+
<p lang="fa" dir="rtl" align="right"> مثال هایی از قبل داخل این فایل نوشته شده که میتونید مثل همونا ازش اصتفاده کنید. اما مثال هایی در قالب پارامتر زده نشده که اینجا باهم انجام میدیم </p>
22+
23+
<p lang="fa" dir="rtl" align="right"> اطلاعات اولیه فایل Router.php </p>
24+
25+
```php
26+
<?php
27+
28+
$router->get('/home', 'home@index');
29+
30+
$router->post('/home', 'home@post');
31+
32+
$router->get('/', function() {
33+
echo 'Welcome ';
34+
});
35+
```
36+
37+
<p lang="fa" dir="rtl" align="right"> برای دریافت پارامتر میتونید این طوری یک روتر بسازید به مثال پایین دقت کنید: </p>
38+
39+
```php
40+
<?php
41+
42+
$router->get('/:name', function($param) {
43+
echo 'Welcome ' . $param['name'];
44+
});
45+
```
46+
<p lang="fa" dir="rtl" align="right"> و اگر من این آدرس رو وارد کنم. yourdomain.com/mohammad </p>
47+
48+
```
49+
wellcome mohammad
50+
```
51+
52+
<p lang="fa" dir="rtl" align="right"> به همین سادگی. </p>
53+
<p lang="fa" dir="rtl" align="right"> خب شاید بگید که چطور ریکوئست های POST رو هندل کنیم؟ مثال زیرو ببینید:</p>
54+
55+
```php
56+
57+
$router->get('/:name', function($param) {
58+
echo 'Welcome ' . $param['name'];
59+
});
60+
61+
// فقط کافیه به جای get بنویسید post
62+
$router->post('/:name', function($param) {
63+
echo 'Welcome ' . $param['name'];
64+
});
65+
66+
```
67+
<h2 lang="fa" dir="rtl" align="right"> ارتباط با دیتابیس</h2>
68+
69+
> <p lang="fa" dir="rtl" align="right">دقت کنید که برای استفاده از دیتابیس شما باید اول فایل config.php رو ویرایش کنید و اطلاعات دیتابیس خودتون رو داخلش وارد کنید</p>
70+
71+
<p lang="fa" dir="rtl" align="right"> حالا میتونید یه فایل مودل در مسیر مشخص خودش بسازید و برای اتصال به دیتابیس و خوندن داده ها از روش زیر استفاده کنید </p>
72+
73+
```php
74+
<?php
75+
76+
use MVC\Model;
77+
78+
class ModelsHome extends Model {
79+
80+
public function getAllUser() {
81+
$query = $this->db->query("SELECT * FROM " . DB_PREFIX . "user");
82+
83+
/*
84+
$query->row : return 1 row
85+
$qurty->rows : return all row
86+
$qurty->num_rows : return row cound
87+
خب خط اولی فقط یک سطر از دیتابیس خروجی میده... واسه زمانیه که شما فقط اطلاعات یک یوزر رو میخایید
88+
خط دوم همه سطر هارو برمیگردونه واسه زمانیه که شما همه یوزر هارو خواسته باشد
89+
و خط سوم هم تعداد سطر های موجود در جدول یوزر رو برمیگردونه
90+
*/
91+
return $qurty->rows;
92+
}
93+
}
94+
```
95+
<p lang="fa" dir="rtl" align="right"> خب توضیحات لازم رو توی خود کد نوشتم. </p>
96+
97+
# این فایل باز هم کامل میشه. تا بعد موفق باشد

0 commit comments

Comments
 (0)