การสร้าง Controller

ให้เปิด Command line แล้วพิมพ์คำสั่ง Artisan CLI ตามด้านล่างนี้ครับ

php artisan make:controller BlogController

Laravel จำทำการสร้างไฟล์ Controller มาให้เราเองซึ่งไฟล์จะอยู่ที่ app\Http\Controllers หลังจากนั้นเราเปิดไฟล์ BlogController.php แล้วเราจะเห็นตัวอย่างโค๊ดที่เขียนมาให้แล้ว

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class BlogController extends Controller
{
    //
}

โดยไฟล์จะถูกสร้างไว้ที่ App/Http/Controllers แต่ถ้าเราไม่ต้องการให้มันสร้างผ่าน Artisan command เราสามารถ Create new file เองก็ได้เช่นกันครับ ไม่มีปัญหา

จากนั้นให้ใส่ ฟังก์ชั่น test() ลงไป จะได้เป็น

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class BlogController extends Controller
{
    public function test()
    {
        echo 'Hello world!';
    }
}

จากนั้นเราต้องไปกำหนดเส้นทางให้ชี้มาที่ Controller และ ฟังก์ชั่น test() ที่เราสร้าง โดยไปกำหนดที่ routes/web.php

<?php
Route::get('blog/test', 'BlogController@test');

ลองทดสอบ ดูบน Chrome จะได้ผลลัพธ์ ตามรูปภาพด้านล่าง

จบแล้วการใช้งาน controller ง่ายไหมครับ สำหรับการใช้งาน Controller ใน Laravel

Middleware In Controller

เพิ่มเติมส่วนของการใช้งาน auth midleware ใน Controller ครับ โดยเราสามารถใช้ middleware ได้โดยนำโค๊ดไปใส่ที่ __construct() ลองดูตัวอย่างโค๊ดด้านล่างนี้ครับ

<?php

namespace App\Http\Controllers;

class BlogController extends Controller
{
    public function __construct()
    {
        $this->middleware('auth');
    }

    public function test()
    {
        echo 'Hello world!';
    }
}

จากตัวอย่างโค๊ดจะสังเกตุเห็นว่า ตอนที่ controller เราจะให้มีการตรวจสอบสิทธิ์ ทุกครั้งก่อนเสมอ

Resource Controllers

เป็นการเขียน Controller ที่มี CRUD (Create, Read, Update, Delete) ครบครัน ด้วยการเขียน routes/web.php เพียงบรรทัดเดียว เท่านั้น อยากให้นึกภาพให้เห็น การที่ Controller เรามีหลายๆ ฟังก์ชั่น เช่น index(), Create(), Show() เราจำเป็นต้องเขียน Routes หลายบรรทัด เช่น

Route::get('index', 'BlogController@index');
Route::get('create', 'BlogController@Create');
Route::get('show', 'BlogController@Show');

แล้วถ้าใน controller มีมากกว่านี้ เราจะทำอย่างไร ดังนั้น Resource Controller จะมาช่วยทำ โดยเราเขียน โค๊ดใน Route เพียงการโค๊ด

Route::resources([
    'blog' => 'BlogController',    
]);

สิ่งที่เราได้จากโค๊ดนี้ เปรียบเสมือนเราเขียน Route แบบนี้ครับ

php artisan make:controller BlogController --resource

สำหรับบทความนี้ก็จบเพียงเท่านี้หากมีปัญหาหรือคำถามใดๆ สามารถสอบถามได้ทาง comment ด้านล่างนี้เลยครับ

The post Laravel – EP6 การใช้งาน Controller first appeared on itOffside.com | บทความการเขียนโปรแกรม เรื่องราวข้อมูลเทคโนโลยี.

Basic Routing

    เส้นทางการร้องขอทั้งหมดของระบบ Laravel จะถูกผ่านมาที่ routes/web.php (สำหรับเว็บ ตัวอย่างบทความนี้ใช้ไฟล์นี้ก่อน) หรือ routes/api.php (สำหรับ APi)

ให้เราเปิดไฟล์ routes/web.php  เราจะเห็น code เขียน

Route::get('/', function () {
    return view('welcome');
});

หมายความว่าเมื่อ request มาหน้าแรก แล้วให้ แสดง view welcome (อยู่ที่ resources/views/welcome.blade.php) จะเห็นได้ว่าเราไม่จำเป็นต้องโยนให้ Controller ก็สามารถทำงานได้เหมือนกัน แต่ที่เราให้ routing โยนให้ Controller ทำงานเพราะ Code จะได้เป็นระเบียบเรียบร้อย

ส่วนหากเราต้องการให้ Routing แล้วโยนให้ Controller ทำงานต่อนั้น ทำได้โดยแบบด้านล่างนี้ครับ

Route::get('/', 'HomeController@index');

ความหมายคือเมื่อ request มาหน้าแรก แล้วสั่งให้ Controller ชื่อ HomeController และ Function index() ทำงานครับ เราลองมาสร้าง Controller กันครับ สามารถสร้างได้ 2 แบบคือ

1. สร้างเอง โดยเข้าไปสร้างไฟล์ที่ app/Http/Controllers/HomeController.php
2. ใช้ Command line Artisan สร้าง โดยให้เราเปิด Command line ในโปรเจ็คของเราก่อนหากใครทำไม่เป็นให้ดูบทความที่ 2 https://www.itoffside.com/laravel-ep2-install/ เมื่อเราเปิด command line แล้วให้พิมพ์คำสั่ง
   

   php artisan make:controller HomeController

   
   แล้ว artisan จะสร้าง controller ไว้ที่ app/Http/Controllers ให้เราเลยครับ ง่ายๆไหมครับ
3. สร้าง function index ใน HomeController
   

เพียงเท่านี้ครับสำหรับการให้ Routing โยนให้ Controller ทำงานต่อแล้ว Controller ก็จะทำงานตามที่เราเขียน code ไว้

Route Parameters

    ในบางครั้งในเว็บ เราจำเป็นต้องมีค่า parameter ส่งไปทาง url เช่น itoffside.com/product/1234 จะเห็นว่า parameter 1234 นั้นเป็นค่าที่อาจจะเป็นค่าอื่นได้เช่นกันเช่น 5678 สำหรับ Routing laravel ก็มีวิธีการส่งค่าเหมือนกัน เรามาดู code กันว่าเขียนแบบไหน

ใน routes/web.php เขียนต่อจากอันเดิมเป็น

Route::get('product/{id}', 'HomeController@product');

จะเห็นว่าเรามีการส่ง parameter {id} ไปด้วย (ชื่ออาจจะเป็นอย่างอื่นก็ได้ไม่จำเป็นต้องเป็น id เอาตามความเข้าใจของเรา) โดย parameter ต้องคลุมด้วย {} เสมอ

แล้วเราก็ไปเขียน code ใน HomeController เพิ่มในบรรทัดที่ 14-17

จาก code หมายถึงเรา สร้าง function product แล้วรับ parameter ที่ routing ส่งมาให้เรา ลองมาดูผลลัพท์ของ code กัน
ปล. อย่าลืม เปิด command แล้ว run คำสั่ง  php artisan serve ด้วยนะครับ

จะเห็นว่าผม request url เป็น product/1234 แล้วใน controller ผมสั่งให้ แสดง parameter 1234 ก็เลยได้ผลลัพท์ตามรูปภาพด้านบน

Routing Methods

    Routing methods คือหนึ่งอย่างที่ Laravel มีความพิเศษ เพราะว่าเราสามารถกำหนด HTTP Verb ได้เช่นเราอยากให้ routing นี้เป็น GET, POST, PUT, DELETE แบบง่ายๆเลย ลองดูตัวอย่าง

Route::get($uri, $callback);
Route::post($uri, $callback);
Route::put($uri, $callback);
Route::patch($uri, $callback);
Route::delete($uri, $callback);
Route::options($uri, $callback);

ผมจะยกตัวอย่างการใช้งาน HTTP Verb ประเภท POST

ในหน้า view ผมเขียน form จะเป็นแบบนี้

<form method="POST" action="/product">
    @csrf
    ...
</form>

โปรดระวังหากเรา request ไม่ตรง verb จะเกิด error ทันที

Routing Groups prefix

    เป็นการจัดกลุ่ม routing โดยอ้างอิงชื่อ prefix ที่เราไม่จำเป็นต้องมาสร้างชื่อซ้ำๆเดิม ยกตัวอย่างเช่นคุณมี Routing 

Route::get('product/{id}', 'productController@show');
Route::post('product', 'productController@store');
Route::put('product/{id}', 'productController@update');
Route::delete('product/{id}', 'productController@destroy');

จะเห็นว่าชื่อ product เรียงกัน ซึ่งเราสามารถจัดเป็นกลุ่มของ prefix “product” ได้โดยเขียนคำสั่งนี้ไป

Route::prefix('product')->group(function () {
    Route::get('{id}', 'productController@show');
    Route::post('', 'productController@store');
    Route::put('{id}', 'productController@update');
    Route::delete('{id}', 'productController@destroy');
});

สรุป

    Routing ใน Laravel นั้นจำเป็นอย่างมาก เพราะ ทุก Request เราต้องควบคุมผ่าน Routing นี้โดย Routing ของ laravel ไม่ได้ Generate อัตโนมัติเหมือน Codeigniter ที่มีรูปแบบ project/controller/methods/{id} ที่เขียนง่าย เริ่มต้นได้ง่าย แต่สำหรับ laravel เราต้องมากำหนด routing เอง ซึ่งตอนแรกอาจจะคิดว่าลำบาก ยาก แต่หากได้ใช้ไปสักพักแล้วมันเป็นอะไรที่ง่ายและสะดวก ดังนั้นเราจึงจำเป็นต้องเรียนรู้และเข้าใจ เพราะหากเราเข้าใจแล้ว เราจะสามรถเขียนเว็บ/ระบบ ได้ดังใจเราต้องการ

The post Laravel – EP5 การกำหนด Routing first appeared on itOffside.com | บทความการเขียนโปรแกรม เรื่องราวข้อมูลเทคโนโลยี.

การตั้งค่าตามสภาพแวดล้อม (Environment Configuration)

สำหรับการตั้งค่าตามสภาพแวดล้อมในที่นี้ผมเรียกสั้นว่า env ครับ โดยเราสามารถเข้าไปตั้งที่ไฟล์ .env หากไม่มี ให้ทำการ copy .env.example แล้ว rename ชื่อเป็น .env ครับ ตามรูปภาพด้านล่าง

แล้วเปิดเข้าไฟล์ .evn จะได้ตาม code ด้านล่าง

APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:3FsGSgfxzhqvXdVqgt+J4slG50AnzqZsc+kxp1pKgzs=
APP_DEBUG=true
APP_URL=http://localhost

LOG_CHANNEL=stack

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret

BROADCAST_DRIVER=log
CACHE_DRIVER=file
QUEUE_CONNECTION=sync
SESSION_DRIVER=file
SESSION_LIFETIME=120

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

MAIL_DRIVER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=

PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
PUSHER_APP_CLUSTER=mt1

MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"

Code ที่ต้องแก้ไข

APP_NAME=Laravel (ชื่อแอพลิเคชั่นของเรา)
APP_DEBUG=true  (เปิดโหมด debug หากเอาขึ้น Production ให้ false)
APP_URL=http://localhost (url ระบบ ของเรา)
DB_CONNECTION=mysql (ชื่อยีห้อของฐานข้อมูลที่เราใช้)
DB_HOST=127.0.0.1 (url ฐานข้อมูล)
DB_PORT=3306 (พอร์ต ฐานข้อมูล)
DB_DATABASE=homestead (ชื่อฐานข้อมูล)
DB_USERNAME=homestead (user ฐานข้อมูล)
DB_PASSWORD=secret (รหัสผ่านฐานข้อมูล)

APP_KEY=base64:3FsGSgfxzhqvXdVqgt+J4slG50AnzqZsc+kxp1pKgzs=
สำหรับ APP_KEY หากยังไม่มีเราสามารถ Generate ได้โดยเปิด command line (วิธีการเปิด Command line) แล้วพิมพ์คำสั่งตาม ด้านล่าง

php artisan key:generate

สำคัญ ตอนที่เราเอาโปรเจ็คขึ้น Server (Production) แล้ว เราไม่ควรนำไฟล์ .env ขึ้นไปด้วย ให้เราไป config ที่ ไฟล์ที่อยู่โฟล์เดอร์ config แทน เช่น เราต้องการ url เราไปแก้ที่ config/app.php ในบรรทัดที่ 55 ตาม Code ด้านล่าง

'url' => env('APP_URL', 'http://itoffside.com'),

หากต้องการแก้ไขฐานข้อมูล ตั้งค่า config ที่ config/database.php

หลังจากเรา Config เสร็จแล้ว ไม่ว่าจะเป็นตอนเราพัฒนาหรือตอนเราเอาขึ้น Production ให้เปิด Command line แล้วพิมพ์คำสั่งด้านล่าง

php artisan config:clear

เพื่อเคลียร์ config เก่า แล้วใช้ config ที่เราเพิ่งทำใหม่

php artisan config:cache

เพื่อเก็บ cache config ไว้ทำให้โปรเจ็คเราทำงานได้เร็วขึ้น

เครื่องมือที่ใช้ในการพัฒนา (Dev Tool)

• การเขียน Code เราใช้ VSCode
  • ให้เราติดตั้ง Extension ดังต่อไปนี้
    • DotENV
    • Laravel Blade Snippets
    • Laravel Blade spacer
    • Laravel-blade
    • Laravel goto view
    • laravel-goto-controller
    • PHP IntelliSense
    • PHP Debug
    • phpfmt – PHP formatter
• XAMPP เวอร์ชั่น 7+ (เป็นโปรแกรมจำลอง Server ในเครื่องเรา)
• Git (ใช้ github ต้องสมัครก่อน ฟรี) เอาไว้เก็บ Code และควบคุม Version ของ Code
• Github Desktop (เป็น gui เพื่อเราไม่ต้องเขียนคำสั่ง git เช่น commit push เป็นต้น)

เครื่องมือในการพัฒนา ที่แนะนำคือ VSCode พร้อมติดตั้ง extension ให้ครบครับเพื่อความเร็วในการทำงานของเราเอง เนื่องจาก extension เหล่านี้มีประโยชน์ เป็นเครื่องทุ่นแรงของเราได้ดีทีเดียว

สรุป

    สำหรับการตั้งค่า เราสามารถตั้งค่าได้ง่ายๆ หากเรากำลังพัฒนาอยู่ ให้ตั้งค่าที่ไฟล์ .env แต่หากเราเอาขึ้น Production แล้ว ต้องไปค่าที่ โฟล์เดอร์ config แทน

    เครื่องมือการพัฒนานั้นเป็นสิ่งที่ผู้เขียนถนัดใช้งาน และใช้อยู่เป็นประจำ หากเราไม่ถนัดก็สามารถใช้อย่างอื่นก็ได้เช่น sublime text เป็นต้น

The post Laravel – EP4 การตั้งค่า Laravel และเครื่องมือที่ใช้ในการพัฒนา first appeared on itOffside.com | บทความการเขียนโปรแกรม เรื่องราวข้อมูลเทคโนโลยี.

โดยโฟล์เดอร์ที่จำเป็นต้องใช้งานบ่อยๆ

• App
  • Http
    • Controller (ควบคุมการทำงาน)
    • Middleware (ตัวกลางระหว่างการทำงานของ system กับ Controller)
• config (ตั้งค่าระบบ)
• database (จัดการฐานข้อมูล เช่น สร้าง แก้ไข และเพิ่มข้อมูลเบื้องต้น)
• public (หลังจาก complie js,css, image แล้วไฟล์จะอยู่ที่นี้)
• resources
  • js (สำหรับเขียน javascript)
  • lang (ทำเว็บหลายภาษา)
  • sass (เขียน style ให้กับระบบ)
  • view (หน้า ui ของระบบ)
• routes (กำหนดเส้นทาง URL)
• storage (จัดเก็บไฟล์ session, cache, หรือไฟล์อัพโหลดของเรา)
• vendor (ที่เก็บ package จาก composer)

    เนื่องจาก Laravel เป็น MVC ดังนั้นเวลาเขียน Controller ให้เขียนไว้ที่ App/Http/Controller, เขียน Model ให้เขียนไว้ที่ App หรือ เราสร้างโฟล์เดอร์ใหม่ แล้วเอาไว้ที่ App/Models แบบนี้ก็ได้, เขียน View ให้เราไปเขียนไว้ที่ resources/view

    ส่วนการเขียนพวก javascript ให้เขียนไว้ที่ resources/js แล้ว complie โดยใช้ webpack (มีสอนบทหลัง), css ก็เช่นกันให้เขียนไว้ที่ resources/css หากไม่มีให้สร้าง โฟล์เดอร์ css หรือคุณจะเขียน sass ก็ได้เพราะอย่างไรก็ต้อง complie อยู่ดี

   ส่วนอื่นๆผมยังไม่ได้พูดถึงนะครับ ผมเล่าในส่วนที่ใช้บ่อยก่อน

สำหรับบทความนี้ก็มีเพียงเท่านี้หากใครมีข้อสงสัยแสดงความคิดเห็นไว้ข้างล่างนี้เลยครับ

The post Laravel – EP3 โครงสร้างของระบบ Laravel first appeared on itOffside.com | บทความการเขียนโปรแกรม เรื่องราวข้อมูลเทคโนโลยี.