Namespaces

Namespaces किस समस्या को हल करते हैं

बड़े project में आपकी अपनी User class हो सकती है, और जो library आपने install की उसमें भी User class हो सकती है। PHP में बिल्कुल एक नाम की दो classes नहीं हो सकतीं — "cannot redeclare" error आती है। Namespaces इसे हल करते हैं, code को एक group नाम देकर, surname की तरह, ताकि दोनों User classes साथ रह सकें।

Namespace define करना

इसे file की पहली statement के रूप में declare कीजिए।

<?php
namespace App\Models;

class User {
    public function greet() {
        return "Hello from App\\Models\\User";
    }
}
?>

अब यह User App\Models की है। दूसरे namespace की कोई और User इससे नहीं टकराएगी।

use के साथ इस्तेमाल

class को use से import कीजिए, फिर छोटे नाम से बुलाइए।

<?php
require "User.php";
use App\Models\User;

$u = new User();
echo $u->greet();
?>

use बिना, हर बार पूरा path लिखना पड़ता: new \App\Models\User()। use line code छोटा और साफ़ रखती है।

as से aliasing

अगर दो classes का नाम एक हो, तो एक को as से locally rename कीजिए।

<?php
use App\Models\User as AppUser;
use Vendor\Auth\User as AuthUser;

$a = new AppUser();
$b = new AuthUser();
?>

अब दोनों "User" classes एक ही file में अलग local नामों से इस्तेमाल हो सकती हैं — न टकराव, न confusion।

Sub-namespaces

Namespaces backslashes से nested हो सकते हैं ताकि folder structure से मेल खाएँ।

<?php
namespace App\Controllers\Admin;
// पूरा नाम: App\Controllers\Admin\DashboardController
class DashboardController { }
?>

Convention से App\Controllers\Admin, folder app/Controllers/Admin/ से मेल खाता है। यही साफ़ मेल autoloaders को classes अपने-आप ढूँढने देता है।

आम गलतियाँ

• namespace पहले नहीं। namespace line <?php के बाद पहली statement होनी चाहिए।
• use भूलना। तब पूरा path लिखना पड़ता है वरना PHP class नहीं ढूँढ पाती।
• / और \ मिलाना। Namespaces backslashes \ इस्तेमाल करते हैं, forward slashes नहीं।
• Import के बाद name clash। एक जैसे नाम वाली दो imports को एक rename करने को as चाहिए।

सारांश

• Namespaces code group करते हैं ताकि एक नाम वाली classes न टकराएँ।
• पहली statement के रूप में namespace App\Models; declare कीजिए।
• use class import करता है ताकि छोटा नाम इस्तेमाल हो।
• as import को rename करके clash बचाता है।
• Namespaces आमतौर पर folders से मेल खाते हैं और autoloading चलाते हैं।

आगे, namespaced classes अपने-आप load कीजिए PHP autoloading से, या code व्यवस्थित कीजिए MVC pattern से।