43 |
44 | render(); ?>
45 |
46 | This is all it takes to create a pagination system! Note that we did not have to inform the framework of the current page. Laravel will determine this for you automatically.
47 |
48 | You may also access additional pagination information via the following methods:
49 |
50 | - `currentPage`
51 | - `lastPage`
52 | - `perPage`
53 | - `hasMorePages`
54 | - `url`
55 | - `nextPageUrl`
56 | - `firstItem`
57 | - `lastItem`
58 | - `total`
59 | - `count`
60 |
61 | #### "Simple Pagination"
62 |
63 | If you are only showing "Next" and "Previous" links in your pagination view, you have the option of using the `simplePaginate` method to perform a more efficient query. This is useful for larger datasets when you do not require the display of exact page numbers on your view:
64 |
65 | $someUsers = User::where('votes', '>', 100)->simplePaginate(15);
66 |
67 | #### Customizing The Paginator URI
68 |
69 | You may also customize the URI used by the paginator via the `setPath` method:
70 |
71 | $users = User::paginate();
72 |
73 | $users->setPath('custom/url');
74 |
75 | The example above will create URLs like the following: http://example.com/custom/url?page=2
76 |
77 |
78 | ## Appending To Pagination Links
79 |
80 | You can add to the query string of pagination links using the `appends` method on the Paginator:
81 |
82 | appends(['sort' => 'votes'])->render(); ?>
83 |
84 | This will generate URLs that look something like this:
85 |
86 | http://example.com/something?page=2&sort=votes
87 |
88 | If you wish to append a "hash fragment" to the paginator's URLs, you may use the `fragment` method:
89 |
90 | fragment('foo')->render(); ?>
91 |
92 | This method call will generate URLs that look something like this:
93 |
94 | http://example.com/something?page=2#foo
95 |
96 |
97 | ## Converting To JSON
98 |
99 | The `Paginator` class implements the `Illuminate\Contracts\Support\JsonableInterface` contract and exposes the `toJson` method. You may also convert a `Paginator` instance to JSON by returning it from a route. The JSON'd form of the instance will include some "meta" information such as `total`, `current_page`, and `last_page`. The instance's data will be available via the `data` key in the JSON array.
100 |
--------------------------------------------------------------------------------
/5.0/providers.md:
--------------------------------------------------------------------------------
1 | # Service Providers
2 |
3 | - [Introduction](#introduction)
4 | - [Basic Provider Example](#basic-provider-example)
5 | - [Registering Providers](#registering-providers)
6 | - [Deferred Providers](#deferred-providers)
7 |
8 |
9 | ## Introduction
10 |
11 | Service providers are the central place of all Laravel application bootstrapping. Your own application, as well as all of Laravel's core services are bootstrapped via service providers.
12 |
13 | But, what do we mean by "bootstrapped"? In general, we mean **registering** things, including registering service container bindings, event listeners, filters, and even routes. Service providers are the central place to configure your application.
14 |
15 | If you open the `config/app.php` file included with Laravel, you will see a `providers` array. These are all of the service provider classes that will be loaded for your application. Of course, many of them are "deferred" providers, meaning they will not be loaded on every request, but only when the services they provide are actually needed.
16 |
17 | In this overview you will learn how to write your own service providers and register them with your Laravel application.
18 |
19 |
20 | ## Basic Provider Example
21 |
22 | All service providers extend the `Illuminate\Support\ServiceProvider` class. This abstract class requires that you define at least one method on your provider: `register`. Within the `register` method, you should **only bind things into the [service container](/docs/{{version}}/container)**. You should never attempt to register any event listeners, routes, or any other piece of functionality within the `register` method.
23 |
24 | The Artisan CLI can easily generate a new provider via the `make:provider` command:
25 |
26 | php artisan make:provider RiakServiceProvider
27 |
28 | ### The Register Method
29 |
30 | Now, let's take a look at a basic service provider:
31 |
32 | app->singleton('Riak\Contracts\Connection', function($app)
47 | {
48 | return new Connection($app['config']['riak']);
49 | });
50 | }
51 |
52 | }
53 |
54 | This service provider only defines a `register` method, and uses that method to define an implementation of `Riak\Contracts\Connection` in the service container. If you don't understand how the service container works, don't worry, [we'll cover that soon](/docs/{{version}}/container).
55 |
56 | This class is namespaced under `App\Providers` since that is the default location for service providers in Laravel. However, you are free to change this as you wish. Your service providers may be placed anywhere that Composer can autoload them.
57 |
58 | ### The Boot Method
59 |
60 | So, what if we need to register an event listener within our service provider? This should be done within the `boot` method. **This method is called after all other service providers have been registered**, meaning you have access to all other services that have been registered by the framework.
61 |
62 | listen('SomeEvent', 'SomeEventHandler');
98 | }
99 |
100 |
101 | ## Registering Providers
102 |
103 | All service providers are registered in the `config/app.php` configuration file. This file contains a `providers` array where you can list the names of your service providers. By default, a set of Laravel core service providers are listed in this array. These providers bootstrap the core Laravel components, such as the mailer, queue, cache, and others.
104 |
105 | To register your provider, simply add it to the array:
106 |
107 | 'providers' => [
108 | // Other Service Providers
109 |
110 | 'App\Providers\AppServiceProvider',
111 | ],
112 |
113 |
114 | ## Deferred Providers
115 |
116 | If your provider is **only** registering bindings in the [service container](/docs/{{version}}/container), you may choose to defer its registration until one of the registered bindings is actually needed. Deferring the loading of such a provider will improve the performance of your application, since it is not loaded from the filesystem on every request.
117 |
118 | To defer the loading of a provider, set the `defer` property to `true` and define a `provides` method. The `provides` method returns the service container bindings that the provider registers:
119 |
120 | app->singleton('Riak\Contracts\Connection', function($app)
142 | {
143 | return new Connection($app['config']['riak']);
144 | });
145 | }
146 |
147 | /**
148 | * Get the services provided by the provider.
149 | *
150 | * @return array
151 | */
152 | public function provides()
153 | {
154 | return ['Riak\Contracts\Connection'];
155 | }
156 |
157 | }
158 |
159 | Laravel compiles and stores a list of all of the services supplied by deferred service providers, along with the name of its service provider class. Then, only when you attempt to resolve one of these services does Laravel load the service provider.
160 |
--------------------------------------------------------------------------------
/5.0/queries.md:
--------------------------------------------------------------------------------
1 | # کوئری ساز
2 |
3 | - [مقدمه](#introduction)
4 | - [دستورات select](#selects)
5 | - [Joins](#joins)
6 | - [دستورات شرطی پیشرفته](#advanced-wheres)
7 | - [اجرای توابع جمعی (Aggregates)](#aggregates)
8 | - [بکارگیری کوئری های توکار (Raw Expression)](#raw-expressions)
9 | - [ایجاد رکورد Insert](#inserts)
10 | - [دستور Update](#updates)
11 | - [حذف رکورد](#deletes)
12 | - [ادغام رکورد ها Union](#unions)
13 | - [قفل Pessimistic](#pessimistic-locking)
14 |
15 |
16 | ## مقدمه
17 | کوئری ساز لاراول یک رابط روان و راحت و ساده برای تولید و اجرای کوئری ها می باشد که میتواند در بیشتر عملیات کار با دیتابیس نیز استفاده شود و برروی تمامی بانکهایی اطلاعاتی که توسط لاراول پشتیبانی میشود قابل اجرا می باشد .
18 |
19 | > **نکته :** کوئری ساز برای نشاندن مقادیر در کوئری ها ، بطور کامل از `PDO parameter binding` استفاده میکند تا وب سایت شما را درمقابل حملات `SQL injection` حفظ کند و دیگر نیازی نیست که پارامتر های ارسالی به کوئری ساز را از نظر کدهای مخرب چک کنید .
20 |
21 |
22 | ## دستورات Select
23 |
24 | #### گرفتن تمامی رکورد های جدول
25 |
26 | $users = DB::table('users')->get();
27 |
28 | foreach ($users as $user)
29 | {
30 | var_dump($user->name);
31 | }
32 |
33 | #### تکه تکه کردن نتایج حاصل از اجرای کوئری select
34 |
35 | DB::table('users')->chunk(100, function($users)
36 | {
37 | foreach ($users as $user)
38 | {
39 | //
40 | }
41 | });
42 |
43 | میتوانید با ارسال مقدار `false` از درون `closure` به اجرای ادامه عملیات خاتمه دهید :
44 |
45 | DB::table('users')->chunk(100, function($users)
46 | {
47 | //
48 |
49 | return false;
50 | });
51 |
52 | #### دریافت یک رکورد از کل نتایج
53 |
54 | $user = DB::table('users')->where('name', 'John')->first();
55 |
56 | var_dump($user->name);
57 |
58 | #### دریافت یک ستون از کل نتایج
59 |
60 | $name = DB::table('users')->where('name', 'John')->pluck('name');
61 |
62 | #### دریافت نتایج بصورت لیست (آرایه)
63 | $roles = DB::table('roles')->lists('title');
64 | این متد یک آرایه از Title ها را برمیگرداند ، همچنین شما میتوانید مقادیر اندیس ها در آرایه را از طریق پارامتر دوم متد `lists` مشخص کنید :
65 |
66 | $roles = DB::table('roles')->lists('title', 'name');
67 |
68 | #### دستور select جهت انتخاب ستون ها
69 |
70 | $users = DB::table('users')->select('name', 'email')->get();
71 |
72 | $users = DB::table('users')->distinct()->get();
73 |
74 | $users = DB::table('users')->select('name as user_name')->get();
75 |
76 | #### اضافه کردن یک ستون دیگر با addSelect
77 |
78 | $query = DB::table('users')->select('name');
79 |
80 | $users = $query->addSelect('age')->get();
81 |
82 | #### دستورات شرطی
83 |
84 | $users = DB::table('users')->where('votes', '>', 100)->get();
85 |
86 | #### دستور Or
87 |
88 | $users = DB::table('users')
89 | ->where('votes', '>', 100)
90 | ->orWhere('name', 'John')
91 | ->get();
92 |
93 | #### جستجو رکورد های که مقدار فیلد x آنها بین دامنه مقادیر داده شده باشد :
94 |
95 | $users = DB::table('users')
96 | ->whereBetween('votes', [1, 100])->get();
97 |
98 | #### جستجو رکورد های که مقدار فیلد x آنها بین دامنه مقادیر داده شده نباشند :
99 |
100 | $users = DB::table('users')
101 | ->whereNotBetween('votes', [1, 100])->get();
102 |
103 | #### جستجو رکورد های که مقدار فیلد x آنها محدود به آرایه داده شده باشد :
104 |
105 | $users = DB::table('users')
106 | ->whereIn('id', [1, 2, 3])->get();
107 |
108 | $users = DB::table('users')
109 | ->whereNotIn('id', [1, 2, 3])->get();
110 |
111 | #### جستجوی رکوردها با مقادیر null .
112 |
113 | $users = DB::table('users')
114 | ->whereNull('updated_at')->get();
115 |
116 | #### دستورات شرط پویا
117 | میتوانید برای تولید دستورات شرطی از عبارات خاصی استفاده کنید تا بتوانید نوع شرط را به روش مفهومی تری بیان نمایید :
118 |
119 | $admin = DB::table('users')->whereId(1)->first();
120 |
121 | $john = DB::table('users')
122 | ->whereIdAndEmail(2, 'john@doe.com')
123 | ->first();
124 |
125 | $jane = DB::table('users')
126 | ->whereNameOrAge('Jane', 22)
127 | ->first();
128 |
129 | #### دستورات Order by , Group by, Having
130 |
131 | $users = DB::table('users')
132 | ->orderBy('name', 'desc')
133 | ->groupBy('count')
134 | ->having('count', '>', 100)
135 | ->get();
136 |
137 | #### دستور Limit
138 |
139 | $users = DB::table('users')->skip(10)->take(5)->get();
140 |
141 |
142 | ## عملیات Join و ضرب دوجدول
143 | برای ضرب دو جدول و Join کردن آنها به شکل زیر عمل کنید :
144 |
145 | #### نمونه ساده Join چند جدول با یکدیگر
146 |
147 | DB::table('users')
148 | ->join('contacts', 'users.id', '=', 'contacts.user_id')
149 | ->join('orders', 'users.id', '=', 'orders.user_id')
150 | ->select('users.id', 'contacts.phone', 'orders.price')
151 | ->get();
152 |
153 | #### عملیات Left Join
154 |
155 | DB::table('users')
156 | ->leftJoin('posts', 'users.id', '=', 'posts.user_id')
157 | ->get();
158 | همچنین میتوانید عملیات Join پیشرفته تری ایجاد کنید :
159 |
160 | DB::table('users')
161 | ->join('contacts', function($join)
162 | {
163 | $join->on('users.id', '=', 'contacts.user_id')->orOn(...);
164 | })
165 | ->get();
166 | میتوانید از دستورات "where" یا "orWhere" برای شرط Join خود استفاده کنید، به عنوان مثال علاوه بر شرط همسان بودن دو فیلد ، فیلد مورد نظر را با یک عدد نیز مقایسه نمایید :
167 |
168 | DB::table('users')
169 | ->join('contacts', function($join)
170 | {
171 | $join->on('users.id', '=', 'contacts.user_id')
172 | ->where('contacts.user_id', '>', 5);
173 | })
174 | ->get();
175 |
176 |
177 | ## دستور Where پیشرفته
178 |
179 | #### تولید کوئری های تو در تو
180 | ممکن است بخواهید دستورات شرطی پیچیده تری را ایجاد کنید یا مثلا از دستور "where exist" برای بررسی موجودیت یک کوئری استفاده نمایید . لاراول برای اجرای اینگونه کوئری ها ، یک راه حل جالب و مفهومی ارائه کرده است :
181 |
182 | DB::table('users')
183 | ->where('name', '=', 'John')
184 | ->orWhere(function($query)
185 | {
186 | $query->where('votes', '>', 100)
187 | ->where('title', '<>', 'Admin');
188 | })
189 | ->get();
190 | دستورات بالا نمونه کوئری زیر را تولید میکنند :
191 |
192 | select * from users where name = 'John' or (votes > 100 and title <> 'Admin')
193 |
194 | #### بررسی موجودیت یک کوئری (Exists Statements)
195 |
196 | DB::table('users')
197 | ->whereExists(function($query)
198 | {
199 | $query->select(DB::raw(1))
200 | ->from('orders')
201 | ->whereRaw('orders.user_id = users.id');
202 | })
203 | ->get();
204 |
205 | دستورات بالا نمونه کوئری زیر را تولید میکنند :
206 |
207 | select * from users
208 | where exists (
209 | select 1 from orders where orders.user_id = users.id
210 | )
211 |
212 |
213 | ## اجرای توابع جمعی (Aggregates)
214 | میتوانید نتیجه دستورات `count`, `max`, `min`, `avg`, و `sum` را توسط کوئری ساز (Query Builder) استخراج نمایید .
215 |
216 | $users = DB::table('users')->count();
217 |
218 | $price = DB::table('orders')->max('price');
219 |
220 | $price = DB::table('orders')->min('price');
221 |
222 | $price = DB::table('orders')->avg('price');
223 |
224 | $total = DB::table('users')->sum('votes');
225 |
226 |
227 | ## بکارگیری از کوئری های توکار (Raw Expression)
228 | برای استفاده از یک کوئری توکار در کوئری ساز (Query Builder) از متد `DB::raw` استفاده میکنیم . حواستان باشد تنها کاربرد این متد بکارگیری یک کوئری در دل کوئری دیگر است ، و این دستور هرگز کوئری ها را از کد های مخرب (Sql Injection) پاک نمیکند .:
229 |
230 | #### نمونه تزریق یک کوئری در یک دستور select
231 |
232 | $users = DB::table('users')
233 | ->select(DB::raw('count(*) as user_count, status'))
234 | ->where('status', '<>', 1)
235 | ->groupBy('status')
236 | ->get();
237 |
238 |
239 | ## دستورات Insert (ایجاد رکود)
240 |
241 | #### ایجاد رکورد جدید در جدول
242 |
243 | DB::table('users')->insert(
244 | ['email' => 'john@example.com', 'votes' => 0]
245 | );
246 |
247 | #### اضافه کردن یک رکورد به جدول همراه با `Auto-Incrementing`
248 | اگر جدول شما دارای یک فیلد Auto-Increment باشد ، میتوانید توسط متد `insertGetId` برای ایجاد رکورد و دریافت مقدار ID رکورد ایجاد شده استفاده نمایید :
249 |
250 | $id = DB::table('users')->insertGetId(
251 | ['email' => 'john@example.com', 'votes' => 0]
252 | );
253 |
254 | > **نکته :** اگر از بانک اطلاعاتی PostgreSQL استفاده میکنید ، برای استفاده از متد `insertGetId` ، نام فیلد کلید اصلی باید برابر `id` باشد .
255 |
256 | #### اضافه کردن چند رکورد به صورت همزمان
257 |
258 | DB::table('users')->insert([
259 | ['email' => 'taylor@example.com', 'votes' => 0],
260 | ['email' => 'dayle@example.com', 'votes' => 0]
261 | ]);
262 |
263 |
264 | ## دستور Update
265 |
266 | #### ویرایش یک رکود در جدول
267 |
268 | DB::table('users')
269 | ->where('id', 1)
270 | ->update(['votes' => 1]);
271 |
272 | #### افزایش و کاهش مقدار یک فیلد در جدول
273 |
274 | DB::table('users')->increment('votes');
275 |
276 | DB::table('users')->increment('votes', 5);
277 |
278 | DB::table('users')->decrement('votes');
279 |
280 | DB::table('users')->decrement('votes', 5);
281 |
282 | میتوانید همزمان فیلد های دیگری را نیز درجدول Update کنید :
283 |
284 | DB::table('users')->increment('votes', 1, ['name' => 'John']);
285 |
286 |
287 | ## حذف رکورد (Delete)
288 |
289 | #### حذف یک رکورد از جدول
290 |
291 | DB::table('users')->where('votes', '<', 100)->delete();
292 |
293 | #### حذف تمامی رکورد های جدول
294 |
295 | DB::table('users')->delete();
296 |
297 | #### خالی کردن یک جدول (Truncating)
298 |
299 | DB::table('users')->truncate();
300 |
301 |
302 | ## دستورات Union (ادغام رکورد ها)
303 | لاراول یک راه سریع برای ادغام دو نتیجه کوئری با یکدیگر ارائه کرده است :
304 |
305 | $first = DB::table('users')->whereNull('first_name');
306 |
307 | $users = DB::table('users')->whereNull('last_name')->union($first)->get();
308 |
309 | متد `unionAll` با روشی مشابه با متد `union` نیز در دسترس می باشد.
310 |
311 |
312 | ## قفل Pessimistic
313 |
314 | کوئری ساز ، قابلیت صدور قفل "pessimistic" بر روی دستورات `Select` را دارد.
315 |
316 | توسط متد `sharedLock` برای کوئری SELECT قفل "pessimistic" ایجاد کنید :
317 |
318 | DB::table('users')->where('votes', '>', 100)->sharedLock()->get();
319 |
320 | و توسط متد lockForUpdate ، هنگام اجرای دستور Select از اجرای Update بر روی آنها جلوگیری نمایید :
321 |
322 | DB::table('users')->where('votes', '>', 100)->lockForUpdate()->get();
323 |
--------------------------------------------------------------------------------
/5.0/readme.md:
--------------------------------------------------------------------------------
1 | # Laravel Documentation
2 |
3 | ## Contribution Guidelines
4 |
5 | If you are submitting documentation for the **current stable release**, submit it to the corresponding branch. For example, documentation for Laravel 5.0 would be submitted to the `5.0` branch. Documentation intended for the next release of Laravel should be submitted to the `master` branch.
6 |
--------------------------------------------------------------------------------
/5.0/redis.md:
--------------------------------------------------------------------------------
1 | # Redis
2 |
3 | - [Introduction](#introduction)
4 | - [Configuration](#configuration)
5 | - [Usage](#usage)
6 | - [Pipelining](#pipelining)
7 |
8 |
9 | ## Introduction
10 |
11 | [Redis](http://redis.io) is an open source, advanced key-value store. It is often referred to as a data structure server since keys can contain [strings](http://redis.io/topics/data-types#strings), [hashes](http://redis.io/topics/data-types#hashes), [lists](http://redis.io/topics/data-types#lists), [sets](http://redis.io/topics/data-types#sets), and [sorted sets](http://redis.io/topics/data-types#sorted-sets).
12 |
13 | Before using Redis with Laravel, you will need to install the `predis/predis` package (~1.0) via Composer.
14 |
15 | > **Note:** If you have the Redis PHP extension installed via PECL, you will need to rename the alias for Redis in your `config/app.php` file.
16 |
17 |
18 | ## Configuration
19 |
20 | The Redis configuration for your application is stored in the `config/database.php` file. Within this file, you will see a `redis` array containing the Redis servers used by your application:
21 |
22 | 'redis' => [
23 |
24 | 'cluster' => true,
25 |
26 | 'default' => ['host' => '127.0.0.1', 'port' => 6379],
27 |
28 | ],
29 |
30 | The default server configuration should suffice for development. However, you are free to modify this array based on your environment. Simply give each Redis server a name, and specify the host and port used by the server.
31 |
32 | The `cluster` option will tell the Laravel Redis client to perform client-side sharding across your Redis nodes, allowing you to pool nodes and create a large amount of available RAM. However, note that client-side sharding does not handle failover; therefore, is primarily suited for cached data that is available from another primary data store.
33 |
34 | If your Redis server requires authentication, you may supply a password by adding a `password` key / value pair to your Redis server configuration array.
35 |
36 |
37 | ## Usage
38 |
39 | You may get a Redis instance by calling the `Redis::connection` method:
40 |
41 | $redis = Redis::connection();
42 |
43 | This will give you an instance of the default Redis server. If you are not using server clustering, you may pass the server name to the `connection` method to get a specific server as defined in your Redis configuration:
44 |
45 | $redis = Redis::connection('other');
46 |
47 | Once you have an instance of the Redis client, we may issue any of the [Redis commands](http://redis.io/commands) to the instance. Laravel uses magic methods to pass the commands to the Redis server:
48 |
49 | $redis->set('name', 'Taylor');
50 |
51 | $name = $redis->get('name');
52 |
53 | $values = $redis->lrange('names', 5, 10);
54 |
55 | Notice the arguments to the command are simply passed into the magic method. Of course, you are not required to use the magic methods, you may also pass commands to the server using the `command` method:
56 |
57 | $values = $redis->command('lrange', [5, 10]);
58 |
59 | When you are simply executing commands against the default connection, just use static magic methods on the `Redis` class:
60 |
61 | Redis::set('name', 'Taylor');
62 |
63 | $name = Redis::get('name');
64 |
65 | $values = Redis::lrange('names', 5, 10);
66 |
67 | > **Note:** Redis [cache](/docs/{{version}}/cache) and [session](/docs/{{version}}/session) drivers are included with Laravel.
68 |
69 |
70 | ## Pipelining
71 |
72 | Pipelining should be used when you need to send many commands to the server in one operation. To get started, use the `pipeline` command:
73 |
74 | #### Piping Many Commands To Your Servers
75 |
76 | Redis::pipeline(function($pipe)
77 | {
78 | for ($i = 0; $i < 1000; $i++)
79 | {
80 | $pipe->set("key:$i", $i);
81 | }
82 | });
83 |
--------------------------------------------------------------------------------
/5.0/requests.md:
--------------------------------------------------------------------------------
1 | # HTTP Requests
2 |
3 | - [دسترسی به یک نمونه از درخواست](#obtaining-a-request-instance)
4 | - [گرفتن ورودی](#retrieving-input)
5 | - [ورودی قبلی](#old-input)
6 | - [کوکی ها](#cookies)
7 | - [فایلها](#files)
8 | - [دیگر اطلاعات درخواست](#other-request-information)
9 |
10 |
11 | ## دسترسی به یک نمونه از درخواست
12 |
13 | ### با استفاده از فاساد
14 |
15 | فاساد `Request` امکان دسترسی به درخواست فعلی که به کانتینر آن وابسته است را ایجاد میکند. برای مثال:
16 |
17 | $name = Request::input('name');
18 |
19 | به یاد داشته باشید، در صورتی که در یک فضای نام هستید، باید فاساد `Request` را با استفاده از عبارت `;use Request` در بالای فایل کلاس ایمپورت نمایید.
20 |
21 | ### با استفاده از تزریق وابستگی - Dependency Injection (DI)
22 |
23 | برای به دست آورد نمونه ای از درخواست HTTP با استفاده از DI، باید کلاس را بر روی سازنده کلاس یا متد مورد نظر تایپ_هینت کنید. نمونه درخواست فعلی خودکار توسط [service container](/docs/%7B%7Bversion%7D%7D/container) تزریق خواهد شد:
24 |
25 | input('name');
41 |
42 | //
43 | }
44 |
45 | }
46 |
47 | در صورتی که متد کنترلر منتظر ورودی از پارامتر روت باشد، به سادگی میتوانید آرگومانهای روت را پس از دیگر وابستگی ها لیست نمایید:
48 |
49 |
71 | ## گرفتن ورودی
72 |
73 | #### گرفتن یک مقدار ورودی
74 |
75 | با استفاده از چند متد ساده، میتوانید تمامی به ورودیهای کاربران در نمونه `Illuminate\Http\Request` دسترسی داشته باشید. از آنجا که تمامی ورودیها برای تمامی متدهای درخواست به یک شکل مورد دسترس قرار میگیرند، نیازی نیست نگران متد درخواست HTTP استفاده شده باشید.
76 |
77 | $name = Request::input('name');
78 |
79 | #### گرفتن یک مقدار پیش فرض درصورتی که مقدار ورودی ارائه نشده باش
80 |
81 | $name = Request::input('name', 'Sally');
82 |
83 | #### بررسی ارئه شدن یک مقدار ورودی
84 |
85 | if (Request::has('name'))
86 | {
87 | //
88 | }
89 |
90 | #### گرفتن تمامی ورودیهای درخواست
91 |
92 | $input = Request::all();
93 |
94 | #### گرفتن تنها برخی ورودیهای درخواست
95 |
96 | $input = Request::only('username', 'password');
97 |
98 | $input = Request::except('credit_card');
99 |
100 | وقتی با فرمهایی با ورودیهای "آرایه" ای کار میکنید، میتوانید برای دسترسی به آرایه ها از . (dot notation) استفاده کنید
101 |
102 | $input = Request::input('products.0.name');
103 |
104 |
105 | ## ورودی های قبلی
106 |
107 | لاراول امکان نگهداری ورودیهای یک درخواست، در طول درخواست بعدی را فراهم نموده است. برای مثال، ممکن است نیاز داشته باشید، پس از اعتبارسنجی یک فرم آن را دوباره با مقادیر پیشین پر کنید.
108 |
109 | #### فلش ورودیهای کاربر درون متغیر نشست (session)
110 |
111 | متد `flash` ورودیهای فعلی را درون متغیر [نشست](/docs/%7B%7Bversion%7D%7D/session) قرار میدهد، تا در طول درخواست بعدی کاربر به نرم افزار در دسترس باشد:
112 |
113 | Request::flash();
114 |
115 | #### فلش برخی از متغیرها درون متغیر نشست
116 |
117 | Request::flashOnly('username', 'email');
118 |
119 | Request::flashExcept('password');
120 |
121 | #### فلش و ردیرکت
122 |
123 | از آنجا که اغلب فلش را در زمان ردیرکت به صفحه قبل انجام میدهید، میتوانید به سادگی فلش ورودیها در یک زنجیره عملیات با ردیرکت انجام دهید:
124 |
125 | return redirect('form')->withInput();
126 |
127 | return redirect('form')->withInput(Request::except('password'));
128 |
129 | #### بازیابی داده های پیشین
130 |
131 | برای بازیابی داده های فلش شده از درخواست پیشین، از متد `old` بر روی نمونه `Request` استفاده کنید:
132 |
133 | $username = Request::old('username');
134 |
135 | اگر داده های پیشین را دریک قالب بلید (Blade) نمایش میدهید، بسیار راحتتر است که از تابع کمکی `old` استفاده نمایید:
136 |
137 | {{ old('username') }}
138 |
139 |
140 | ## کوکیها
141 |
142 | تمامی کوکیهای ایجاد شده توسط فریمورک لاراول با استفاده از یک کد سنجش هویت رمزنگاری و امضا شده اند، به این معنی که در صورت تغییر آنها توسط کلاینت غیر معتبر خواهند بود.
143 |
144 | #### خواندن مقدار کوکی
145 |
146 | $value = Request::cookie('name');
147 |
148 | #### پیوست کوکی به یک درخواست جدید
149 |
150 | تابع کمکی `cookie` به عنوان یک سازنده جدید برای ایجاد نمونه های جدید از `Symfony\Component\HttpFoundation\Cookie` عمل مینماید. کوکیها را میتوان با استفاده از متد `withCookie` به یک نمونه از `Response` پیوست کرد:
151 |
152 | $response = new Illuminate\Http\Response('Hello World');
153 |
154 | $response->withCookie(cookie('name', 'value', $minutes));
155 |
156 | #### ایجاد یک کوکی که تا ابد میماند*
157 |
158 | _منظور از "ابد" واقعا پنج سال است_
159 |
160 | $response->withCookie(cookie()->forever('name', 'value'));
161 |
162 | #### قراردادن کوکیها در صف
163 |
164 | شما میتوانید کوکی را حتی پیش از آنکه پاسخ ایجاد گردد، به "صف" اضاف نمایید تا پیوست شود:
165 |
166 |
187 | ## فایلها
188 |
189 | #### گرفتن یک فایل آپلود شده
190 |
191 | $file = Request::file('photo');
192 |
193 | #### بررسی وجود فایل در درخواست
194 |
195 | if (Request::hasFile('photo'))
196 | {
197 | //
198 | }
199 |
200 | شی بازگردانده شده توسط متد `file` نمونه ای از کلاس `Symfony\Component\HttpFoundation\File\UploadedFile` است، که کلاس `SplFileInfo` از PHP را اکستند میکند و متدهای بسیاری برای کار با فایلها ارائه مینماید.
201 |
202 | #### بررسی معتبر بودن فایل آپلود شده
203 |
204 | if (Request::file('photo')->isValid())
205 | {
206 | //
207 | }
208 |
209 | #### جابجایی فایل آپلود شده
210 |
211 | Request::file('photo')->move($destinationPath);
212 |
213 | Request::file('photo')->move($destinationPath, $fileName);
214 |
215 | ### دیگر متدهای فایل
216 |
217 | There are a variety of other methods available on `UploadedFile` instances. Check out the [API documentation for the class](http://api.symfony.com/2.5/Symfony/Component/HttpFoundation/File/UploadedFile.html) for more information regarding these methods.
218 | متدهای متنوع بسیاری در نمونه های `UploadedFile` وجود دارند. [مستندات API را برای اطلاعات بیشتر این کلاس](http://api.symfony.com/2.5/Symfony/Component/HttpFoundation/File/UploadedFile.html) بررسی نمایید.
219 |
220 |
221 | ## دیگر اطلاعات درخواست
222 |
223 | The `Request` class provides many methods for examining the HTTP request for your application and extends the `Symfony\Component\HttpFoundation\Request` class. Here are some of the highlights.
224 | کلاس `Request` متدهای بسیاری برای بررسی درخواستهای HTTP ارسال شده برای نرم افزار کاربردی وب ارائه مینماید و کلاس `Symfony\Component\HttpFoundation\Request` را اکستند میکند.
225 |
226 | #### گرفتن URI مروبط به درخواست
227 |
228 | $uri = Request::path();
229 |
230 | #### بررسی استفاده از AJAX توسط درخواست
231 |
232 | if (Request::ajax())
233 | {
234 | //
235 | }
236 |
237 | #### گرفتن ممتد درخواست
238 |
239 | $method = Request::method();
240 |
241 | if (Request::isMethod('post'))
242 | {
243 | //
244 | }
245 |
246 | #### بررسی همخوانی مسیر درخواست با الگویی مشخص
247 |
248 | if (Request::is('admin/*'))
249 | {
250 | //
251 | }
252 |
253 | #### گرفتن URL درخواست جاری
254 |
255 | $url = Request::url();
256 |
--------------------------------------------------------------------------------
/5.0/responses.md:
--------------------------------------------------------------------------------
1 | # پاسخ های HTTP
2 |
3 | - [مقدمه](#basic-responses)
4 | - [ریدایرکت ها (redirects)](#redirects)
5 | - [انواع دیگر پاسخ ها](#other-responses)
6 | - [Macro ها ](#response-macros)
7 |
8 |
9 | ## مقدمه
10 |
11 | #### نمونه ساده ارسال یک پاسخ (response) از درون Route
12 |
13 | متداول ترین نوع پاسخ در لاراول از درون یک Route، پاسخ String می باشد .
14 |
15 | Route::get('/', function()
16 | {
17 | return 'Hello World';
18 | });
19 |
20 | #### ایجاد پاسخ های سفارشی
21 |
22 | اما ، در بسیاری از Route ها و Controller-actions ها ،به شما یک نمونه از کلاس `Illuminate\Http\Response` یا یک [view](/docs/{{version}}/views) بعنوان پاسخ ارسال میشود که این امکان را میدهد به راحتی `HTTP status code` و `Headers ` ها را دستکاری کنید .
23 | نمونه ایحاد شده `Response` از کلاس `Symfony\Component\HttpFoundation\Response` ارث میبرد ، که انواع مختلفی از متدها را برای ساخت یک پاسخ HTTP شامل میشود .
24 |
25 | use Illuminate\Http\Response;
26 |
27 | return (new Response($content, $status))
28 | ->header('Content-Type', $value);
29 |
30 | برای آسودگی بیشتر ، شما میتوانید از تابع کمکی `response` نیز استفاده کنید :
31 |
32 | return response($content, $status)
33 | ->header('Content-Type', $value);
34 |
35 | #### ارسال View به عنوان پاسخ
36 |
37 | اگر نیازمندید که از قابلیت های `response` و متد های آن استفاده کنید (مثلا دستکاری Header ها) و همزمان یک View به عنوان پاسخ به خروجی ارسال کنید میتوانید از متد `view` استفاده نمایید .
38 |
39 | return response()->view('hello')->header('Content-Type', $type);
40 |
41 | #### ارسال کوکی در کنار response
42 |
43 | return response($content)->withCookie(cookie('name', 'value'));
44 |
45 | #### استفاده ذنجیره ای متد ها درکنار هم
46 |
47 | به یاد داشته باشید که بیشتر متدهای `response` قابلیت استفاده ذنجیره ای دارند که کار را برای شما بسیار راحت میکند .
48 |
49 | return response()->view('hello')->header('Content-Type', $type)
50 | ->withCookie(cookie('name', 'value'));
51 |
52 |
53 | ## ریدایرکت ها (redirects)
54 | یکی از مورد استفاده ترین Response ها ریدایرکت ها هستند که یک نمونه از کلاس `Illuminate\Http\RedirectResponse` میباشند .
55 |
56 | #### ارسال پاسخ از نوع ریداریکت (redirect)
57 | روش های مختلفی برای ایجاد یک پاسخ از نوع `RedirectResponse` وجود دارد که ساده ترین آن استفاده از تابع کمکی `redirect` است . در زمان تست ، ایجاد یک پاسخ ریداریکت ساختگی متداول نیست ! بنابراین استفاده از تابع کمکی `redirect` همیشه و در همه حال قابل قبول می باشد .
58 |
59 | return redirect('user/login');
60 |
61 | #### پاسخ ریداریکت به همراه ارسال متغیر
62 | ریداریکت به یک URL جدید و [انتقال متغیر به Session](/docs/{{version}}/session) معمولا به صورت همزمان انجام میشود . بنابراین برای راحتی بیشتر میتوانید یک نمونه از `RedirectResponse` ایجاد کنید و متغیر ها را از طریق یک متد بصورت ذنجیره وار به session انتقال دهید :
63 |
64 | return redirect('user/login')->with('message', 'Login Failed');
65 |
66 | #### ریدایرکت به URL پیشین
67 | ممکن است بخواهید کاربر را به مکان قبل (آدرس URL پیشین) منتقل کنید ، برای مثال ، بعد از اینکه یک فرم اطلاعاتی را در دیتابیس ذخیره کردید ، میتوانید بوسیله متد `back` کاربر را به صفحه ای که فرم در آن ثبت شده انتقال دهید :
68 |
69 | return redirect()->back();
70 |
71 | return redirect()->back()->withInput();
72 |
73 | #### ریداریکت به یک Route از طریق نام آن
74 | زمانی که از تابع کمکی`redirect` بدون پارامتر استفاده میکنید لاراول به شما یک نمونه از کلاس `Illuminate\Routing\Redirector` برمیگرداند ، که میتوانید از متد های آن استفاده نمایید . برای مثال یک `RedirectResponse` را برای یک روت از طریق نام آن توسط متد `route` میتوانید ایجاد کنید :
75 |
76 | return redirect()->route('login');
77 |
78 | #### ریداریکت به یک Route از طریق نام آن و ارسال پارامتر
79 | اگر روت شما داری پارامتر می باشد ، میتوانید از طریق آرگومان دوم متد `route` آنها را تعریف کنید :
80 |
81 | // For a route with the following URI: profile/{id}
82 |
83 | return redirect()->route('profile', [1]);
84 |
85 | درصورتی که پارامتر شما یک مدل Eloquent باشد لاراول بطور پیشفرض خصوصیت فیلد ID را از درون مدل استخراج کرده و به عنوان پارامتر ارسال میکند :
86 |
87 | return redirect()->route('profile', [$user]);
88 |
89 | #### ریداریکت به یک Route از طریق نام آن و ارسال مقدار به یک پارامتر نامگذاری شده
90 | // For a route with the following URI: profile/{user}
91 |
92 | return redirect()->route('profile', ['user' => 1]);
93 |
94 | #### ریداریکت به یک کنترلر و اکشن
95 | همانند ریدایرکت به یک Route شما میتوانید به یک [controller actions](/docs/{{version}}/controllers) خاص نیز ریداریکت کنید :
96 |
97 | return redirect()->action('App\Http\Controllers\HomeController@index');
98 |
99 | > **نکته :** درصورتی که مسیر namespace ریشه کنترلرها رو از طریق متد `URL::setRootControllerNamespace` مشخص کنید دیگر نیاز نخواهید داشت `namespace` کامل را در کلاس URL وارد کنید .
100 |
101 | #### ریداریکت به یک [controller actions](/docs/{{version}}/controllers) و ارسال پارامتر به آن :
102 |
103 | return redirect()->action('App\Http\Controllers\UserController@profile', [1]);
104 |
105 | #### ریداریکت به یک [controller actions](/docs/{{version}}/controllers) و ارسال مقدار به یک پارامتر نامگذاری شده :
106 | return redirect()->action('App\Http\Controllers\UserController@profile', ['user' => 1]);
107 |
108 |
109 | ## انواع دیگر پاسخ ها
110 | تابع کمکی `response` برای تولید انواع دیگر پاسخ ها (,JSONP , JSON , دانلود , ...) نیز بکار میرود . زمانیکه تابع کمکی `response` را بدون آرگومان صدا بزنید ، یک Implementation از کلاس `Illuminate\Contracts\Routing\ResponseFactory` [contract](/docs/{{version}}/contracts) باز گردانده می شود . که این `contract` متد های مفیدی برای تولید انواع پاسخ در خود دارد .
111 |
112 | #### ارسال یک پاسخ JSON
113 | متد json بصورت خودکار مقدار هدر `Content-Type` را `application/json` قرار میدهد :
114 |
115 | return response()->json(['name' => 'Abigail', 'state' => 'CA']);
116 |
117 | #### ارسال یک پاسخ JSONP
118 |
119 | return response()->json(['name' => 'Abigail', 'state' => 'CA'])
120 | ->setCallback($request->input('callback'));
121 |
122 | #### ارسال پاسخ به صورت دانلود فایل
123 |
124 | return response()->download($pathToFile);
125 |
126 | return response()->download($pathToFile, $name, $headers);
127 |
128 | return response()->download($pathToFile)->deleteFileAfterSend(true);
129 |
130 | > **نکته :** کلاس Symfony HttpFoundation , که وظیفه مدیریت دانلود را بر عهده دارد , نیازمند این می باشد که نام فایل دانلودی ، شامل کاراکتر های ASCII باشد .
131 |
132 |
133 | ## Response Macros
134 | ماکرو ها این امکان را میدهند که متد های `response` را سفارشی کنید و آنها را در قسمت های مختلف پروژه (کنترلر ها و Route ها و ..) استفاده کنید .
135 | برای مثال , تعریف ماکرو در متد `boot` از یک [service provider](/docs/{{version}}/providers) :
136 |
137 | caps('foo');
162 |
--------------------------------------------------------------------------------
/5.0/schema.md:
--------------------------------------------------------------------------------
1 | # سازنده اسکیما - Schema Builder
2 |
3 | - [آشنایی](#introduction)
4 | - [ایجاد و حذف جدولها](#creating-and-dropping-tables)
5 | - [افزودن ستونها](#adding-columns)
6 | - [تغییر ستونها](#changing-columns)
7 | - [تغییرنام ستونها](#renaming-columns)
8 | - [حذف ستونها](#dropping-columns)
9 | - [بررسی وجود ستون](#checking-existence)
10 | - [افزودن ایندکس](#adding-indexes)
11 | - [کلیدهای خارجی](#foreign-keys)
12 | - [حذف ایندکس](#dropping-indexes)
13 | - [حذف تایم استمپ و حذف های موقت](#dropping-timestamps)
14 | - [موتورهای ذخیره سازی - Storage Engines](#storage-engines)
15 |
16 |
17 | ## آشنایی
18 |
19 | کلاس `Schema` لاراول روشی مستقل از پایگاه داده برای انجام تغییرات بر روی جدولها ارائه مینماید. این کلاس با تمامی پایگاه داده هایی که توسط لاراول پشتیبانی میشوند به خوبی کارمیکند، و برای تمامی این سیستمها یک واسط توسعه یکسان دارد.
20 |
21 |
22 | ## ایجاد و حذف جداول
23 |
24 | برای ایجاد یک جدول پایگاه داده جدید، متد `Schema::create` استفاده می شود:
25 |
26 | Schema::create('users', function($table)
27 | {
28 | $table->increments('id');
29 | });
30 |
31 | آرگومان اولی که به متد `create` فرستاده می شود، اسم جدول است، و آرگومان دوم یک `Closure` است. این کلوژر یک شی `Blueprint` میپذیرد که برای تعریف جدول می توان از آن استفاده کرد.
32 |
33 | برای تغییر نام یک جدول پایگاه داده، میتوان از متد `rename` استفاده کرد:
34 |
35 | Schema::rename($from, $to);
36 |
37 | برای مشخص کردن اتصال پایگاه داده مورد استفاده در انجام عملیات، از متد `Schema::connection` استفاده کنید:
38 |
39 | Schema::connection('foo')->create('users', function($table)
40 | {
41 | $table->increments('id');
42 | });
43 |
44 | برای حذف یک جدول، میتوانید از متد `Schema::drop` استفاده کنید:
45 |
46 | Schema::drop('users');
47 |
48 | Schema::dropIfExists('users');
49 |
50 |
51 | ## افزودن ستونها
52 |
53 | برای به روزرسانی یک جدول، از متد `Schema::table` استفاده میکنیم:
54 |
55 | Schema::table('users', function($table)
56 | {
57 | $table->string('email');
58 | });
59 |
60 | schema builder نوع ستونهای متفاوتی را معرفی میکند که در زمان ساخت جدولها میتوان از آنها استفاده کرد:
61 |
62 | دستور | تعریف
63 | ------------- | -------------
64 | `$table->bigIncrements('id');` | افزایش مقدار ID با استفاده از معادل "big integer"
65 | `$table->bigInteger('votes');` | معادل BIGINT برای جدول
66 | `$table->binary('data');` | معادل BLOB جدول
67 | `$table->boolean('confirmed');` | معادل BOOLEAN جدول
68 | `$table->char('name', 4);` | معدل CHAR در جدول
69 | `$table->date('created_at');` | معادل DATE در جدول
70 | `$table->dateTime('created_at');` | معدل DATETIME برای جدول
71 | `$table->decimal('amount', 5, 2);` | معادل DECIMAL با مقدار صحیح و اعشار
72 | `$table->double('column', 15, 8);` | معادل DOUBLE با اعشار، در مجموع 15 رقم با 8 رقم اعشار
73 | `$table->enum('choices', ['foo', 'bar']);` | معادل ENUM در جدول
74 | `$table->float('amount');` | معادل FLOAT در جدول
75 | `$table->increments('id');` | افزایش ID در جدول
76 | `$table->integer('votes');` | معادل INTEGER در جدول
77 | `$table->json('options');` | معادل JSON در جدول
78 | `$table->jsonb('options');` | معادل JSONB در جدول
79 | `$table->longText('description');` | معادل LONGTEXT در جدول
80 | `$table->mediumInteger('numbers');` | معادل MEDIUMINT در جدول
81 | `$table->mediumText('description');` | معادل MEDIUMTEXT در جدول
82 | `$table->morphs('taggable');` | ستون INTEGER با عنوان 'taggable_id' و STRING با عنوان 'taggable_type' به جدول اضاف میکند
83 | `$table->nullableTimestamps();` | مشابه متد timestamp() با این تفاوت که امکان NULL بودن مقدار وجود دارد
84 | `$table->smallInteger('votes');` | معادل SMALLINT در جدول
85 | `$table->tinyInteger('numbers');` | معادل TINYINT در جدول
86 | `$table->softDeletes();` | ستون **deleted\_at** را برای امکان حذف موقت به جدول می افزاید
87 | `$table->string('email');` | معادل ستون VARCHAR در جدول
88 | `$table->string('name', 100);` | معادل ستون VARCHAR با امکان ارائه اندازه
89 | `$table->text('description');` | معادل TEXT در جدول
90 | `$table->time('sunrise');` | معادل TIME در جدول
91 | `$table->timestamp('added_on');` | معادل TIMESTAMP در جدول
92 | `$table->timestamps();` | ستونهای **created\_at** و **updated\_at** را به جدول می افزاید
93 | `$table->rememberToken();` | ستون remember_token با نوع VARCHAR(100) و امکان NULL بودن می افزاید
94 | `->nullable()` | اشاره میکند که ستون امکان NULL بودن را هم دارد.
95 | `->default($value)` | یک مقدار پیشفرض برای ستون تعیین میکند.
96 | `->unsigned()` | نوع INTEGER را به UNSIGNED تغییر میدهد.
97 |
98 | #### استفاده از after در MySQL
99 |
100 | اگر از پایگاه داده MySQL استفاده میکنید، میتوانید از متد `after` برای مشخص کردن ترتیب ستونها استفاده کنید:
101 |
102 | $table->string('name')->after('email');
103 |
104 |
105 | ## تغییر ستونها
106 |
107 | **نکته:** پیش از تغییر ستون، مطمئن باشید وابستگی `doctrine/dbal` را به فایل `composer.json` افزوده اید.
108 |
109 | گاهی نیاز به تغییر یک ستون از جدول دارید. برای مثال، گاهی نیاز به افزایش طول string یک ستون دارید. متد `change` این کار را به سادگی انجام میدهد! برای مثال، اندازه ستون `name` را از 25 به 50 افزایش میدهیم:
110 |
111 | Schema::table('users', function($table)
112 | {
113 | $table->string('name', 50)->change();
114 | });
115 |
116 | همچنین میتوان وضعیت یک ستون را به `Nullable` تغییر داد:
117 |
118 | Schema::table('users', function($table)
119 | {
120 | $table->string('name', 50)->nullable()->change();
121 | });
122 |
123 |
124 | ## تغییر نام یک ستون
125 |
126 | برای تغییر نام ستون، میتوانید از متد `renameColumn` در Schema builder استفاده کنید. پیش از تغییر نام ستون، وابستگی `doctorine/dbal` را به فایل `composer.json` بیافزایید.
127 |
128 | Schema::table('users', function($table)
129 | {
130 | $table->renameColumn('from', 'to');
131 | });
132 |
133 | > **نکته:** تغییر نام در جدولی با ستونی از جنس `enum` در حال حاضر پشتیبانی نمیشود.
134 |
135 |
136 | ## حذف ستونها
137 |
138 | برای حذف یک ستون، میتوانید از متد `dropColumn` در Schema builder استفاده کنید. پیش از حذف یک ستون وابستگی `doctorine/dbal` را به فایل `composer.json` بیافزایید.
139 |
140 | #### حذف یک ستون از یک جدول
141 |
142 | Schema::table('users', function($table)
143 | {
144 | $table->dropColumn('votes');
145 | });
146 |
147 | #### حذف چند ستون از جدول
148 |
149 | Schema::table('users', function($table)
150 | {
151 | $table->dropColumn(['votes', 'avatar', 'location']);
152 | });
153 |
154 |
155 | ## بررسی وجود
156 |
157 | #### بررسی وجود یک جدول
158 |
159 | میتوانید برای بررسی وجود یا عدم وجود یک جدول یا ستون از متدهای `hasTable` یا `hasColumn` استفاده کنید:
160 |
161 | if (Schema::hasTable('users'))
162 | {
163 | //
164 | }
165 |
166 | #### بررسی وجود یک ستون
167 |
168 | if (Schema::hasColumn('users', 'email'))
169 | {
170 | //
171 | }
172 |
173 |
174 | ## افزودن ایندکس
175 |
176 | Schema builder چندین نوع ایندکس از چند نوع ایندکس پشتیبانی میکند. دو راه برای افزودن آنها وجود دارد. راه اول، میتوانید آن را مستقیما هنگام معرفی ستون تعریف کنید، یا در مرحله ای مجزا آنها را بیافزایید:
177 | $table->string('email')->unique();
178 |
179 | یا میتوانید ایندکس را در خطی مجزا بیافزایید. در ادامه لیستی از نوع ایندکسهای موجود ارائه شده اند:
180 |
181 | Command | Description
182 | ------------- | -------------
183 | `$table->primary('id');` | افزودن کلید اصلی
184 | `$table->primary(['first', 'last']);` | افزودن کلید ترکیبی
185 | `$table->unique('email');` | افزودن ایندکس یکتا
186 | `$table->index('state');` | افزودن ایندکس پایه ای
187 |
188 |
189 | ## کلید خارجی
190 |
191 | لاراول امکان افزودن محدودیت کلید خارجی به جداول را نیز فراهم مینماید:
192 |
193 | $table->integer('user_id')->unsigned();
194 | $table->foreign('user_id')->references('id')->on('users');
195 |
196 | در این مثال، تعریف کرده ایم که ستون `user_id` به ستون `id` از جدول `users` اشاره میکند. پیش از اینکار از ساخته شدن کلید خارجی مطمئن شوید.
197 |
198 | همچنین برای عملیاتهای "on update" و "on delete" میتوانید با پارامترهایی که میفرستید شرایط را هم تعیین نمایید:
199 |
200 | $table->foreign('user_id')
201 | ->references('id')->on('users')
202 | ->onDelete('cascade');
203 |
204 | برای حذف یک کلید خارجی، میتوانید از متد `dropForeign` استفاده کنید. قرارداد نامگذاری استفاده شده برای کلیدهای خارجی دقیقا مشابه آنچه در نامگذاری ایندکسها استفاده میشود است.
205 |
206 | $table->dropForeign('posts_user_id_foreign');
207 |
208 | > **نکته:** هنگام ایجاد یک کلید خارجی که به یک Integer با افزایش مقدار خودکار اشاره دارد، به یاد داشته باشید همیشه ستون کلید خارجی را `unsigned` قرار دهید.
209 |
210 |
211 | ## حذف ایندکسها
212 |
213 | برای حذف ایندکس باید نام آن را مشخص نمایید. لاراول به صورت پیش فرض یک نام منطقی به ایندکس انتصاب میدهد. این کار با ترکیب نام جدول، نام ستونی که در ایندکس آمده، و نوع ایندکس مشخص می شود. در ادامه چند مثال را میبینید:
214 |
215 | فرمان | توصیف
216 | ------------- | -------------
217 | `$table->dropPrimary('users_id_primary');` | حذف یک کلید اصلی از جدول "users"
218 | `$table->dropUnique('users_email_unique');` | حذف یک ایندکس یکتا از جدول "users"
219 | `$table->dropIndex('geo_state_index');` | حذف یک ایندکس ابتدایی از جدول "geo"
220 |
221 |
222 | ## حذف تایم استمپها و حذفهای موقت
223 |
224 | برای حذف ستونهای از جنس `timestamps`، `nullableTimestamps`، softDeletes میتوانید از متدهای زیر استفاده کنید:
225 |
226 | فرمان | توصیف
227 | ------------- | -------------
228 | `$table->dropTimestamps();` | حذف ستونهای **created\_at** و **updated\_at** از جدول
229 | `$table->dropSoftDeletes();` | حذف ستون **deleted\_at** از جدول
230 |
231 |
232 | ## موتورهای ذخیره سازی
233 |
234 | برای تعیین موتور ذخیره سازی برای یک جدول، مقدار خصوصیت `engine` را بر روی schema builder مقداردهی کنید:
235 |
236 | Schema::create('users', function($table)
237 | {
238 | $table->engine = 'InnoDB';
239 |
240 | $table->string('email');
241 | });
242 |
--------------------------------------------------------------------------------
/5.0/session.md:
--------------------------------------------------------------------------------
1 | # نشست - Session
2 |
3 | - [پیکربندی](#configuration)
4 | - [کاربرد نشست](#session-usage)
5 | - [Flash Data](#flash-data)
6 | - [نشستهای پایگاه داده](#database-sessions)
7 | - [درایورهای نشست](#session-drivers)
8 |
9 |
10 | ## پیکربندی
11 |
12 | از آنجاکه نرم افزارهای مبتنی بر HTTP وضعیت اتصالها را نگاه نمیدارند (stateless)، نشستها به عنوان راه حلی برای نگاهداری اطلاعات کاربران در بین درخواستهاست. لاراول امکانات زیادی برای استفاده در یک API شسته رفته و یکپارچه دارد. پشتیبانی از بک اندهایی مانند [Memcached](http://memcached.org) و [Redis](http://redis.io) و پایگاههای داده در لاراول انجام می شود.
13 |
14 | تنظیمات نشست در فایل `config/session.php` ذخیره می شوند. اطمینان حاصل کنید که گزینه های این فایل را به دقت مطالعه نمایید. به صورت پیش فرض، لاراول برای استفاده از درایور نشست `file` تنظیم شده است. این درایور برای عموم نرم افزارها به خوبی کار میکند.
15 |
16 | پیش از استفاده از نشستهای Redis در لاراول باید بسته `predis/predis` (~1.0) را از طریق کامپوزر نصب کنید.
17 |
18 | > **نکته:** اگر داده های نشستهای شما باید رمزگذاری شوند، مقدار گزینه `encrypt` را برابر با `true قرار دهید.
19 |
20 | > **نکته:** هنگام استفاده از درایور نشست `cookie`، به هیچ وجه نباید middleware با عنوان `EncryptCookie` را از کرنل HTTP حذف نمایید. اگر این middleware را حذف کنید، نرم افزار در مقابل code injection آسیب پذیر خواهد بود.
21 |
22 | #### کلیدهای رزروشده
23 |
24 | فریمورک لاراول از کلید نشست `flash` به طور پیش فرض استفاده میکند. بنابراین شما نباید موردی را با این اسم به نشست بیافزایید.
25 |
26 |
27 | ## کاربرد نشست
28 |
29 | به چند روش میتوان به نشستها دسترسی داشت، با استفاده از متد `session` از درخواستهای HTTPT، با استفاده از فاساد `Session`، یا تابع کمکی `session`. اگر تابع کمکی `session` بدون آرگومان فراخوانی شود، خروجی آن کل شی نشست خواهد بود. برای مثال:
30 |
31 | session()->regenerate();
32 |
33 | #### ذخیره یک عنصر در نشست
34 |
35 | Session::put('key', 'value');
36 |
37 | session(['key' => 'value']);
38 |
39 | #### افزودن یک مقدار به آرایه ای در نشست
40 |
41 | Session::push('user.teams', 'developers');
42 |
43 | #### خواندن یک مقدار از نشست
44 |
45 | $value = Session::get('key');
46 |
47 | $value = session('key');
48 |
49 | #### خواندن یک مقدار از نشست یا بازگرداندن مقدار پیش فرض
50 |
51 | $value = Session::get('key', 'default');
52 |
53 | $value = Session::get('key', function() { return 'default'; });
54 |
55 | #### خواندن مقدار از نشست و حذف آن
56 |
57 | $value = Session::pull('key', 'default');
58 |
59 | #### خواندن تمامی مقادیر از نشست
60 |
61 | $data = Session::all();
62 |
63 | #### بررسی وجود یک مقدار در نشست
64 |
65 | if (Session::has('users'))
66 | {
67 | //
68 | }
69 |
70 | #### حذف یک مقدار از نشست
71 |
72 | Session::forget('key');
73 |
74 | #### حذف تمامی مقدارها از نشست
75 |
76 | Session::flush();
77 |
78 | #### تولید مجدد ID نشست
79 |
80 | Session::regenerate();
81 |
82 |
83 | ## فلش داده ها - Flash Data
84 |
85 | گاهی میخواهید اطلاعات را تنها برای درخواست بعدی در session ذخیره کنید. اینکار را با استفاده از متد `Session::flash` میتوانید انجام دهید.
86 |
87 | Session::flash('key', 'value');
88 |
89 | #### فلش مجدد داده ها فعلی برای session بعدی
90 |
91 | Session::reflash();
92 |
93 | #### فلش مجدد تنها بخشی از داده ها
94 |
95 | Session::keep(['username', 'email']);
96 |
97 |
98 | ## سشن های پایگاه داده
99 |
100 | برای استفاده از درایور نشست `database`، باید جدولی برای نگاهداری عناصر نشست ایجاد شود. در ادامه یک تعریف `Schema` از این جدول ارائه شده است:
101 |
102 | Schema::create('sessions', function($table)
103 | {
104 | $table->string('id')->unique();
105 | $table->text('payload');
106 | $table->integer('last_activity');
107 | });
108 |
109 | البته میتوانید از فرمان آرتیزان `session::table` برای ایجاد این میگریشن استفاده کنید!
110 |
111 | php artisan session:table
112 |
113 | composer dump-autoload
114 |
115 | php artisan migrate
116 |
117 |
118 | ## درایورهای نشست - Session Drivers
119 |
120 | درایور نشست مکان ذخیره سازی داده های نشست برای هر درخواست را مشخص میکند. لاراول درایورهای بسیاری با خود دارد:
121 |
122 | - `file` - نشستها در `storage/framework/sessions` ذخیره میشوند.
123 | - `cookie` - نشستهای در کوکیهای کدگذاری شده نگهداری میشوند.
124 | - `database` -نشستها در پایگاه داده استفاده شده استفاده شده توسط نرم افزار شما ذخیره میشوند.
125 | - `memcached` / `redis` - نشستها در یکی از این کشهای سریع و امن نگاهداری میشوند.
126 | - `array` - نشستها در آرایه های ساده PHP نگاهداری می شوند و ما بین درخواستهای مختلف حفظ نمی شوند.
127 |
128 | > **نکته:** درایورarray معمولا برای اجرای [unit test](/docs/%7B%7Bversion%7D%7D/testing) ها استفاده می شود، بنابراین هیچ داده ای ذخیره دائم نمیشود.
129 |
--------------------------------------------------------------------------------
/5.0/structure.md:
--------------------------------------------------------------------------------
1 | # ساختار برنامه
2 |
3 | - [آشنایی](#introduction)
4 | - [Root دایرکتوری ](#the-root-directory)
5 | - [App دایرکتوری ](#the-app-directory)
6 | - [فضای نامی برنامه ی شما](#namespacing-your-application)
7 |
8 |
9 | ## آشنایی
10 |
11 | به صورت پیش فرض ساختار دایرکتوری ها در فریم ورک لاراول طوری در نظر گرفته شده است که نقطه ی شروع مناسبی برای برنامه های کوچک و بزرگ باشد . البته شما برای سازماندهی کردن دایرکتوری های برنامه ی خودتان ,کاملا آزاد هستین و تقریبا می توان گفت هیچ محدودیتی از طرف لاراول برای محل قرار گیری کلاس ها وجود ندارد و کامپوزر می تواند آنها را بارگزاری نماید .
12 |
13 |
14 |
15 |
16 | ## Root دایرکتوری
17 |
18 | زمان نصب یک لاراول جدید , دایرکتوری روت شامل فولدرهای متعددی است :
19 |
20 |
21 | همانطور که انتظار می رود , دایرکتوری root شامل کدهای هسته ی برنامه ی شما می باشد . ما به زودی این فولدر و جزییات آن را شرح می دهیم .
22 |
23 | فولدر `bootstrap` شامل فایل های اندکی به منظور راه اندازی فریم ورک و پیکربندی های خودکار می باشد .
24 |
25 |
26 | فولدر `config` همانطور که از نام آن می توان حدس زد شامل فایل های تنظیمات و پیکربندی های برنامه ی شما می باشد .
27 |
28 |
29 | فولدر `database` شامل تمام migration و seeds های برنامه ی شما می باشد .
30 |
31 | فولدر `public` شامل تمام فایل های بخش Front پروژه و assets ها می باشد (عکس ها ,استایل ها ,فایل های جاوااسکریپت و غیره)
32 |
33 | فولدر `resources` شامل تمام view ها , فایل های مربوط به زبان و همچنین فایل هایی مانند LESS, SASS, CoffeeScript می باشد .
34 |
35 | فولدر `storage` شامل تمام فایل های کامپایل شده قالب Blade , سشن ها ,کش ها و دیگر فایل های تولید شده به وسلیه فریم ورک می باشد .
36 |
37 | فولدر `test` شامل فایل های تست خودکار می باشد.
38 |
39 | فولدر `vendor` شامل تمام پکیج های مورد نیاز می باشد .
40 |
41 |
42 | ## App دایرکتوری
43 |
44 | قسمت اصلی برنامه ی شما در فولدر `app` می باشد و این فولدر تحت فضای نامی App است و به صورت خودکار به وسیله ی کامپوزر و استاندارد [PSR-4 autoloading standard](http://www.php-fig.org/psr/psr-4/) بارگزاری می شود .شما می توانید با فرمان آرتیسان app:name این فضای نامی را به دلخواه خود عوض نمایید.
45 |
46 | فولدر `app` شامل فولدرهای مختلفی مانند `Console`, `Http` و `Providers` می باشد . فولدرهای `Console`, `Http` را به منظور ارایه دهنده ی API ای داخل برنامه ی خود درنظر بگیرید و همچنین پروتوکل HTTP و CLI هر دو مکانیزمی به منظور تعامل با برنامه شما می باشند.به عبارت دیگر آنها ۲ راه ساده ی ارسال پیام در برنامه ی شما هستند.
47 | فولدر Console شامل تمام فرمان های Artisan هست و فولدر Http شامل تمام کنترلرها , فیلترها و requests ها می باشد .
48 | فولدر Commands در واقع محلی برای تمام commandsهای برنامه شما می باشد .
49 | فولدر Events همانطور که از نام اش انتظار می رود محل نگهداری کلاس های event می باشد .برای استفاده از event ها لازم نیست از این کلاس ها استفاده کنید , با این حال اگر می خواهید از آنها استفاده کنید , این فولدر محل پیشفرض event هایی است که با فرمان Artisan ایجاد می شوند .
50 |
51 | فولدر `Handlers` شامل تمام کلاس های handler برای commands و events ها می باشد.Handlers ها یک command یا event را دریافت می کنند و زمانی که آنها فراخوانی می شوند , منطق آنها را اجرا کرده و در پاسخ به آنها ارسال می کند .
52 | فولدر `Services` شامل سرویس هایی است که برنامه ی شما در طول اجرا به آن نیاز دارد .برای مثال سرویس `Registrar` مسئول اعتبارسنجی و ایجاد یک کاربر جدید در برنامه ی شما است و یا سرویس هایی که با API های بیرونی ارتباط برقرار می کنند و یا حتی سرویس هایی که داده ها را در برنامه ی شما جمع آوری می کنند .
53 | فولدر `Exceptions` شامل تمام استثناها و exception های برنامه ی شما است و همچنین محل مناسبی برای رسیدگی به exception های رخ داده شده در برنامه می باشد .
54 |
55 | > **توجه داشته باشید:** بسیاری از کلاس های داخل فولدر`app` را می توان با فرمان های artisan ایجاد نمود.به منظور مرور این فرمان ها در ترمینال خود , `php artisan list make` را اجرا نمایید.
56 |
57 |
58 | ## فضای نامی برنامه ی شما
59 |
60 | همانطور که در بالا صحبت کردیم namespace یا فضای نام پیش فرض برنامه, App می باشد هرچند که شما به راحتی با توجه به نام برنامه خودتان می توانید آن را تغییر دهید و این کار از طریق فرمان آرتیسان app:name صورت می گیرد . به عنوان مثال اگر نام برنامه ی شما SocialNet باشد , شما فرمان زیر را می توانید اجرا نمایید.
61 |
62 | php artisan app:name SocialNet
63 |
--------------------------------------------------------------------------------
/5.0/templates.md:
--------------------------------------------------------------------------------
1 | # قالبها - Templates
2 |
3 | - [کتابخانه ساخت قالب Blade](#blade-templating)
4 | - [دیگر ساختارهای کنترل Blade](#other-blade-control-structures)
5 |
6 |
7 | ## کتابخانه ساخت قالب Blade
8 |
9 | Blade یک موتور ساده و در عین حال قدرتمند ایجاد قالب است که همراه لاراول ارائه می شود. برخلاف قالبهای کنترلر، کار Blade برپایه _ارث بری قالبها_ و _بخشها_ بنا شده است. تمامی قالبهای Blade باید از پسوند `blade.php.` استفاده کنند.
10 |
11 | #### تعریف یک لی اوت(layout) مبتنی بر Blade
12 |
13 |
14 |
15 |
16 |
17 | App Name - @yield('title')
18 |
19 |
20 | @section('sidebar')
21 | This is the master sidebar.
22 | @show
23 |
24 |
44 | @stop
45 |
46 | اگر به viewها دقت کنید یک لی اوت Blade را `extend` میکند. با این کار میتوانید بخشهای مشخص شده جایگزین کنید. در viewهایی که این لی اوت را استفاده میکنند، محتوای لی اوت با استفاده از راهنمای (directive) تعریف شده `parent@@` قابل دسترس است. در این بخشها میتوان محتوای لی اوت را با بخشهایی مانند منوکنار (side bar)، و یا فوتر جانمایی کرد.
47 |
48 | گاهی که از تعریف شدن یک بخش اطمینان ندارید، میتوانید یک مقدار پیش فرض به راهنمای `yield@` بفرستید. مقدار پیش فرض را میتوانید به عنوان پارامتر دوم بفرستید:
49 |
50 | @yield('section', 'Default Content')
51 |
52 |
53 | ## دیگر ساختارهای کنترلی Blade
54 |
55 | #### چاپ داده
56 |
57 | Hello, {{ $name }}.
58 |
59 | The current UNIX timestamp is {{ time() }}.
60 |
61 | #### چاپ داده پس از بررسی وجود
62 |
63 | گاهی میخواهید داده ای را چاپ نمایید اما از مقداردهی شدن آن اطمینان ندارید. به سادگی میتوانید روش زیر را استفاده کنید:
64 |
65 | {{ isset($name) ? $name : 'Default' }}
66 |
67 | Blade به جای استفاده از عبارت ترنری (ternary) بالا، امکان استفاده از ساختار زیر را فراهم میکند:
68 |
69 | {{ $name or 'Default' }}
70 |
71 | #### نمایش متن خام در آکولاد
72 |
73 | اگر میخواهید یک رشته متن را که در آکولاد قراردارد نمایش دهید، میتوانید با استفاده از علامت `@` پیش از متن، از تفسیر آکولادها توسط Blade جلوگیری کنید:
74 |
75 | @{{ این متن توسط Blade پردازش نمیشود }}
76 |
77 | اگر میخواهید داده های درون متن هنوز نمایش داده شوند از قالب زیر استفاده کنید:
78 |
79 | Hello, {!! $name !!}.
80 |
81 | > **نکته:** هنگام چاپ محتوایی که توسط کاربران نرم افزار ارائه شده اند بسیار مراقب باشید. همیشه برای نمایش موجودیتهای HTML درون متن از جفت-آکولاد استفاده کنید.
82 |
83 | #### عبارات if
84 |
85 | @if (count($records) === 1)
86 | I have one record!
87 | @elseif (count($records) > 1)
88 | I have multiple records!
89 | @else
90 | I don't have any records!
91 | @endif
92 |
93 | @unless (Auth::check())
94 | You are not signed in.
95 | @endunless
96 |
97 | #### حلقه های تکرار
98 |
99 | @for ($i = 0; $i < 10; $i++)
100 | The current value is {{ $i }}
101 | @endfor
102 |
103 | @foreach ($users as $user)
104 |
115 | @endwhile
116 |
117 | #### استفاده از زیرviewها
118 |
119 | @include('view.name')
120 |
121 | میتوانید آرایه ای از داده به view استفاده شده بفرستید:
122 |
123 | @include('view.name', ['some' => 'data'])
124 |
125 | #### بازنویسی بخشها
126 |
127 | برای بازنویسی کل یک بخش، میتوانید از عبارت `overwrite` استفاده کنید:
128 |
129 | @extends('list.item.container')
130 |
131 | @section('list.item.content')
132 |
This is an item of type {{ $item->type }}
133 | @overwrite
134 |
135 | #### نمایش خطوط زبان
136 |
137 | @lang('language.line')
138 |
139 | @choice('language.line', 1)
140 |
141 | #### کامنتها
142 |
143 | {{-- این بخش در HTML نهایی نخواهد بود --}}
144 |
145 |
--------------------------------------------------------------------------------
/5.0/test.txt:
--------------------------------------------------------------------------------
1 | This is a test.
--------------------------------------------------------------------------------
/5.0/testing.md:
--------------------------------------------------------------------------------
1 | # Testing
2 |
3 | - [Introduction](#introduction)
4 | - [Defining & Running Tests](#defining-and-running-tests)
5 | - [Test Environment](#test-environment)
6 | - [Calling Routes From Tests](#calling-routes-from-tests)
7 | - [Mocking Facades](#mocking-facades)
8 | - [Framework Assertions](#framework-assertions)
9 | - [Helper Methods](#helper-methods)
10 | - [Refreshing The Application](#refreshing-the-application)
11 |
12 |
13 | ## Introduction
14 |
15 | Laravel is built with unit testing in mind. In fact, support for testing with PHPUnit is included out of the box, and a `phpunit.xml` file is already setup for your application.
16 |
17 | An example test file is provided in the `tests` directory. After installing a new Laravel application, simply run `phpunit` on the command line to run your tests.
18 |
19 |
20 | ## Defining & Running Tests
21 |
22 | To create a test case, simply create a new test file in the `tests` directory. The test class should extend `TestCase`. You may then define test methods as you normally would when using PHPUnit.
23 |
24 | #### An Example Test Class
25 |
26 | class FooTest extends TestCase {
27 |
28 | public function testSomethingIsTrue()
29 | {
30 | $this->assertTrue(true);
31 | }
32 |
33 | }
34 |
35 | You may run all of the tests for your application by executing the `phpunit` command from your terminal.
36 |
37 | > **Note:** If you define your own `setUp` method, be sure to call `parent::setUp`.
38 |
39 |
40 | ## Test Environment
41 |
42 | When running unit tests, Laravel will automatically set the configuration environment to `testing`. Also, Laravel includes configuration files for `session` and `cache` in the test environment. Both of these drivers are set to `array` while in the test environment, meaning no session or cache data will be persisted while testing. You are free to create other testing environment configurations as necessary.
43 |
44 | The `testing` environment variables may be configured in the `phpunit.xml` file.
45 |
46 |
47 | ## Calling Routes From Tests
48 |
49 | #### Calling A Route From A Test
50 |
51 | You may easily call one of your routes for a test using the `call` method:
52 |
53 | $response = $this->call('GET', 'user/profile');
54 |
55 | $response = $this->call($method, $uri, $parameters, $cookies, $files, $server, $content);
56 |
57 | You may then inspect the `Illuminate\Http\Response` object:
58 |
59 | $this->assertEquals('Hello World', $response->getContent());
60 |
61 | #### Calling A Controller From A Test
62 |
63 | You may also call a controller from a test:
64 |
65 | $response = $this->action('GET', 'HomeController@index');
66 |
67 | $response = $this->action('GET', 'UserController@profile', ['user' => 1]);
68 |
69 | > **Note:** You do not need to specify the full controller namespace when using the `action` method. Only specify the portion of the class name that follows the `App\Http\Controllers` namespace.
70 |
71 | The `getContent` method will return the evaluated string contents of the response. If your route returns a `View`, you may access it using the `original` property:
72 |
73 | $view = $response->original;
74 |
75 | $this->assertEquals('John', $view['name']);
76 |
77 | To call a HTTPS route, you may use the `callSecure` method:
78 |
79 | $response = $this->callSecure('GET', 'foo/bar');
80 |
81 |
82 | ## Mocking Facades
83 |
84 | When testing, you may often want to mock a call to a Laravel static facade. For example, consider the following controller action:
85 |
86 | public function getIndex()
87 | {
88 | Event::fire('foo', ['name' => 'Dayle']);
89 |
90 | return 'All done!';
91 | }
92 |
93 | We can mock the call to the `Event` class by using the `shouldReceive` method on the facade, which will return an instance of a [Mockery](https://github.com/padraic/mockery) mock.
94 |
95 | #### Mocking A Facade
96 |
97 | public function testGetIndex()
98 | {
99 | Event::shouldReceive('fire')->once()->with('foo', ['name' => 'Dayle']);
100 |
101 | $this->call('GET', '/');
102 | }
103 |
104 | > **Note:** You should not mock the `Request` facade. Instead, pass the input you desire into the `call` method when running your test.
105 |
106 |
107 | ## Framework Assertions
108 |
109 | Laravel ships with several `assert` methods to make testing a little easier:
110 |
111 | #### Asserting Responses Are OK
112 |
113 | public function testMethod()
114 | {
115 | $this->call('GET', '/');
116 |
117 | $this->assertResponseOk();
118 | }
119 |
120 | #### Asserting Response Statuses
121 |
122 | $this->assertResponseStatus(403);
123 |
124 | #### Asserting Responses Are Redirects
125 |
126 | $this->assertRedirectedTo('foo');
127 |
128 | $this->assertRedirectedToRoute('route.name');
129 |
130 | $this->assertRedirectedToAction('Controller@method');
131 |
132 | #### Asserting A View Has Some Data
133 |
134 | public function testMethod()
135 | {
136 | $this->call('GET', '/');
137 |
138 | $this->assertViewHas('name');
139 | $this->assertViewHas('age', $value);
140 | }
141 |
142 | #### Asserting The Session Has Some Data
143 |
144 | public function testMethod()
145 | {
146 | $this->call('GET', '/');
147 |
148 | $this->assertSessionHas('name');
149 | $this->assertSessionHas('age', $value);
150 | }
151 |
152 | #### Asserting The Session Has Errors
153 |
154 | public function testMethod()
155 | {
156 | $this->call('GET', '/');
157 |
158 | $this->assertSessionHasErrors();
159 |
160 | // Asserting the session has errors for a given key...
161 | $this->assertSessionHasErrors('name');
162 |
163 | // Asserting the session has errors for several keys...
164 | $this->assertSessionHasErrors(['name', 'age']);
165 | }
166 |
167 | #### Asserting Old Input Has Some Data
168 |
169 | public function testMethod()
170 | {
171 | $this->call('GET', '/');
172 |
173 | $this->assertHasOldInput();
174 | }
175 |
176 |
177 | ## Helper Methods
178 |
179 | The `TestCase` class contains several helper methods to make testing your application easier.
180 |
181 | #### Setting And Flushing Sessions From Tests
182 |
183 | $this->session(['foo' => 'bar']);
184 |
185 | $this->flushSession();
186 |
187 | #### Setting The Currently Authenticated User
188 |
189 | You may set the currently authenticated user using the `be` method:
190 |
191 | $user = new User(['name' => 'John']);
192 |
193 | $this->be($user);
194 |
195 | You may re-seed your database from a test using the `seed` method:
196 |
197 | #### Re-Seeding Database From Tests
198 |
199 | $this->seed();
200 |
201 | $this->seed('DatabaseSeeder');
202 |
203 | More information on creating seeds may be found in the [migrations and seeding](/docs/migrations#database-seeding) section of the documentation.
204 |
205 |
206 | ## Refreshing The Application
207 |
208 | As you may already know, you can access your Application ([service container](/docs/{{version}}/container)) via `$this->app` from any test method. This service container instance is refreshed for each test class. If you wish to manually force the Application to be refreshed for a given method, you may use the `refreshApplication` method from your test method. This will reset any extra bindings, such as mocks, that have been placed in the IoC container since the test case started running.
209 |
--------------------------------------------------------------------------------
/5.0/views.md:
--------------------------------------------------------------------------------
1 | # Views
2 |
3 | - [کاربرد پایه ای ](#basic-usage)
4 | - [View Composers](#view-composers)
5 |
6 |
7 | ## کاربرد ابتدایی
8 |
9 | viewها شامل کد HTML نرم افزار وب شما هستند، و روشی ساده برای جداکردن کنترلر و منطق کاری از منطق نمایشی هستند. viewها در دایرکتوری `resources/views` قراردارند.
10 |
11 | یک view ساده به شکل زیر است:
12 |
13 |
14 |
15 |
16 |
17 |
Hello,
18 |
19 |
20 |
21 | این view را میتوانید به این شکل به مرورگر بفرستید:
22 |
23 | Route::get('/', function()
24 | {
25 | return view('greeting', ['name' => 'James']);
26 | });
27 |
28 | همانطور که میبینید، اولین آرگومان فرستاده شده برای تابع کمکی `view` به نام فایل view در `resources/views` دایرکتوری اشاره دارد. آرگومان دوم فرستاده شده به تابع کمکی آرایه ای داده هاست که درview استفاده میشود.
29 |
30 | البته، viewها میتوانند در پوشه های تودرتو از دایرکتوری `resources/views` قرار داشته باشند. برای مثال، اگر view در `resources/views/admin/profile.php` ذخیره شده باشد، باید به این شکل استفاده شود:
31 |
32 | return view('admin.profile', $data);
33 |
34 | #### ارسال داده به view
35 |
36 | // Using conventional approach
37 | $view = view('greeting')->with('name', 'Victoria');
38 |
39 | // Using Magic Methods
40 | $view = view('greeting')->withName('Victoria');
41 |
42 | در مثال بالا، متغیر `$name` در دسترس view قرار دارد و حاوی مقدار `Victoria` است.
43 |
44 | میتوانید یک آرایه داده را به عنوان پارامتر دوم به تابع کمکی `view` بفرستید:
45 |
46 | $view = view('greetings', $data);
47 |
48 | هنگام انتقال اطلاعات به این شکل، `data` باید آرایه ای با مقادیر کلید/مقدار باشد. درون view، میتوانید با استفاده از کلید مربوط به هر مقدار به آن دست پیدا کنید. برای مثال با فرض وجود `$data['key']` میتوان از `{{ $key }}` درview برای دسترسی به داده استفاده کرد.
49 |
50 | #### اشتراک داده با تمام viewها
51 |
52 | گاهی، ممکن است بخواهید داده ای را در دسترس تمامی viewهای به نمایش درآمده توسط نرم افزارتان قرار دهید. گزینه های زیادی برای این کار دارید: تابع کمکی `view`، [کانترکت](/docs/%7B%7Bversion%7D%7D/contracts) `Illuminate\Contracts\View\Factory`، و یا استفاده از یک وایلدکارد [view کامپوزر](#view-composers).
53 |
54 | برای مثال روش استفاده از تابع کمکی `view`:
55 |
56 | view()->share('data', [1, 2, 3]);
57 |
58 | همچنین میتوانید از فاساد `View` استفاده کنید:
59 |
60 | View::share('data', [1, 2, 3]);
61 |
62 | به طور معمول، فراخوانی متد `share` را در متد `boot` یک service provider قرار میدهیم. اما میتوانید آن را به `AppServiceProvider` بیافزایید یا یک service provider مجزا برای مدیریت به اشتراک گذاری داده با تمام view ها ایجاد کنید.
63 |
64 | > **نکته:** هنگامی که تابع کمکی `view` بدون آرگومان فراخوانی شود، یک پیاده سازی از کانترکت `Illuminate\Contracts\View\Factory` ایجاد میکند.
65 |
66 | #### بررسی وجود view
67 |
68 | اگر میخواهید وجود یک view را بررسی نمایید، میتوانید از متد `exists` استفاده کنید:
69 |
70 | if (view()->exists('emails.customer'))
71 | {
72 | //
73 | }
74 |
75 | #### فراخوانی view از مسیر فایل
76 |
77 | اگر بخواهید میتوانید یک view با استفاده از آدرس مسیر کامل یک فایل ایجاد نمایید:
78 |
79 | return view()->file($pathToFile, $data);
80 |
81 |
82 | ## View Composers
83 |
84 | view composerها کالبکها یا متدهای کلاس هستند که هنگام رندر view فراخوانی میشوند. اگر داده ای دارید که با هر بار رندرشدن، بخواهید به view بایند شود، view composer آن منطق را در یک مکان مدیریت شده نگاهداری میکند.
85 |
86 | #### تعریف یک View Composer
87 |
88 | میتوانیم view composerها را درون یک [service provider](/docs/%7B%7Bversion%7D%7D/providers) قرار دهیم. از فاساد `View` برای دستیابی به کانترکت یک نمونه از `Illuminate\Contracts\View\Factory` استفاده میکنیم:
89 |
90 | **نکته:** لاراول پوشه پیش فرضی برای view composerها ندارد. برای دسته بندی آنها هرکجا که بخواهید آزاد هستید. برای مثال، میتوانید یک دایرکتوری `App\Http\ViewComposers` ایجاد کنید.
127 |
128 | به یاد داشته باشید، باید service provider را به آرایه `providers` در فایل پیکربندی `config/app.php` بیافزایید.
129 |
130 | حال که composer را معرفی کرده ایم، متد `ProfileComposer@compose` با هر بار رندرشدن `profile` فراخوانی میشود. در ادامه کلاس composer را تعریف میکنیم:
131 |
132 | users = $users;
156 | }
157 |
158 | /**
159 | * Bind data to the view.
160 | *
161 | * @param View $view
162 | * @return void
163 | */
164 | public function compose(View $view)
165 | {
166 | $view->with('count', $this->users->count());
167 | }
168 |
169 | }
170 |
171 | درست پیش از رندرشدن view، متد `compose` با نمونه کلاس `Illuminate\Contracts\View\View` فراخوانی میشود. بای بایند داده به view میتوانید از متد `with` استفاده کنید.
172 |
173 | > **نکته:** تمامی view composerها از طریق service container تشخیص داده می شوند، بنابراین میتوانید هر وابستگی مورد نیاز را در composer constructor اعلان نوع کنید.
174 |
175 | #### Wildcard View Composers
176 |
177 | متد `composer` کاراکتر `*` را به عنوان وایلدکارد میپذیرد، و به این واسطه شما میتوانید یک composer را برای تمام viewها استفاده نمایید.
178 |
179 | View::composer('*', function($view)
180 | {
181 | //
182 | });
183 |
184 | #### پیوست یک composer به چند view
185 |
186 | میتوانید یک view composer را برای چندین view به طور همزمان استفاده نمایید:
187 |
188 | View::composer(['profile', 'dashboard'], 'App\Http\ViewComposers\MyViewComposer');
189 |
190 | #### تعریف چند composer
191 |
192 | میتوانید از متد `composers` برای ثبت گروهی از composerها به طور همزمان استفاده کنید:
193 |
194 | View::composers([
195 | 'App\Http\ViewComposers\AdminComposer' => ['admin.index', 'admin.profile'],
196 | 'App\Http\ViewComposers\UserComposer' => 'user',
197 | 'App\Http\ViewComposers\ProductComposer' => 'product'
198 | ]);
199 |
200 | ### view creator - سازنده های view
201 |
202 | **سازنده**های view عملکردی شبیه به view composerها دارند؛ هرچند، آنها درست زمان ساخته شدن view اجرا می شوند. برای ثبت یک سازنده view، از متد `creator` استفاده کنید:
203 |
204 | View::creator('profile', 'App\Http\ViewCreators\ProfileCreator');
205 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # مستندات
2 | Persian documents for laravel
3 |
4 | مستندات فارسی لاراول
5 |
6 | برای مشارکت در ترجمه مستندات و توسعه آن میتوانید ریپازیتوری موجود را فورک کرده و پس از اعمال تغییرات و/یا افزودن فایل جدید ترجمه یا مستندات جدید درخواست ترکیب با ریپازیتوری اصلی ایجاد نمایید و پس از تایید، آخرین تغییرات خود را بر روی ریپازیتوری نهایی قرار دهید.
7 |
8 | ترجمه های انجام شده با نام شما در بخش مستندات سایت لارابوک قرار میگیرد.
9 |
10 | www.larabook.ir/docs
11 |
12 | **نکته:** دقت داشته باشید مستندات مربوط به هر نسخه لاراول را به برنچ مربوط به خود بفرستید. برای مثال مستندات نسخه 5.0 لاراول را به برنچ 5.0 بفرستید
13 |
14 |
15 | **پدید آورندگان**
16 | - علی رضا هنرمند
17 | - حامد پاکدامن
18 |
--------------------------------------------------------------------------------