1. Laravel Telescope क्या है और इसकी ज़रूरत क्यों है?

Laravel Telescope, Laravel टीम द्वारा विकसित एक शक्तिशाली डीबगिंग और मॉनिटरिंग टूल है। यह डेवलपर्स को ऐप के अंदर होने वाली हर चीज़ पर "इंस्पेक्टर जैसी नज़र" देता है: इनकमिंग रिक्वेस्ट और SQL क्वेरी से लेकर क्यू जॉब्स, एक्सेप्शन और लॉग्स तक। Telescope एक कंट्रोल पैनल की तरह काम करता है जो रियल-टाइम में सारी टेलीमेट्री इकट्ठा करके दिखाता है।

इसकी ज़रूरत क्यों है? आधुनिक वेब डेवलपमेंट में एप्लिकेशन काफी जटिल हो गए हैं: क्यू, कैशिंग, बाहरी API, जटिल SQL क्वेरी का इस्तेमाल होता है। Telescope जैसे टूल के बिना, डेवलपर को मैन्युअली कोड में dd() या Log::debug() जोड़नी पड़ती है, जिससे डेवलपमेंट धीमा हो जाता है और पूरी तस्वीर नहीं मिलती। Telescope हर रिक्वेस्ट का डेटा अपने आप इकट्ठा करता है, जिसमें एक्ज़ीक्यूशन टाइम, DB क्वेरी की संख्या, इस्तेमाल की गई मेमोरी और भी बहुत कुछ शामिल होता है। यह डीबगिंग को अंदाज़े से सटीक विज्ञान में बदल देता है।

Telescope की सबसे बड़ी खासियत है इसकी "बिना दखल" वाली प्रकृति। यह "आउट ऑफ द बॉक्स" काम करता है और ऐप के कोड में बदलाव की ज़रूरत नहीं होती। डेटा डेटाबेस (डिफ़ॉल्ट रूप से MySQL या SQLite) में स्टोर होता है, जिससे रिक्वेस्ट का इतिहास विश्लेषण किया जा सकता है। Telescope API डेवलपमेंट, क्यू के साथ काम करने और धीमे पेजों को डीबग करने में विशेष रूप से उपयोगी है।

2. इंस्टॉलेशन

Laravel Telescope को Composer के ज़रिए इंस्टॉल किया जाता है, जो PHP का स्टैंडर्ड पैकेज मैनेजर है। अपने Laravel प्रोजेक्ट की रूट डायरेक्टरी में नीचे दिया गया कमांड चलाएँ:

composer require laravel/telescope --dev

--dev फ्लैग ज़रूरी है: Telescope सिर्फ लोकल डेवलपमेंट के लिए है और इसे प्रोडक्शन सर्वर पर इंस्टॉल नहीं करना चाहिए। पैकेज इंस्टॉल करने के बाद, एसेट्स (CSS/JS) और कॉन्फ़िगरेशन को पब्लिश करना होगा:

php artisan telescope:install

यह कमांड config/telescope.php कॉन्फ़िगरेशन फ़ाइल और डेटाबेस माइग्रेशन बनाएगा। फिर Telescope डेटा स्टोर करने के लिए टेबल बनाने हेतु माइग्रेशन चलाएँ:

php artisan migrate

इसके बाद Telescope आपके ऐप के /telescope पते पर उपलब्ध होगा। अगर आप Laravel Sail (Docker) का उपयोग कर रहे हैं, तो कंटेनर को रीस्टार्ट करना न भूलें।

3. त्वरित शुरुआत — न्यूनतम कार्यशील उदाहरण

इंस्टॉलेशन के बाद, Telescope अपने आप डेटा इकट्ठा करना शुरू कर देता है। आपको कोई अतिरिक्त कोड लिखने की ज़रूरत नहीं है। बस ब्राउज़र खोलें और http://your-app.test/telescope पर जाएँ।

आपको टैब के साथ एक पैनल दिखेगा: Requests, Commands, Schedule, Jobs, Exceptions, Logs, Dumps, Queries, Models, Mail, Notifications, Cache, Events, Gates।

यह जाँचने के लिए कि सब कुछ काम कर रहा है, अपने ऐप के किसी भी रूट पर एक साधारण रिक्वेस्ट करें। उदाहरण के लिए, होम पेज खोलें। फिर Telescope में जाएँ और Requests टैब चुनें। आपको अपनी रिक्वेस्ट की एक एंट्री दिखेगी जिसमें विवरण होंगे: मेथड, URI, स्टेटस, अवधि, SQL क्वेरी की संख्या आदि।

यहाँ एक उदाहरण है कि आप डीबगिंग के लिए मैन्युअली Telescope में डेटा कैसे जोड़ सकते हैं:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\User;
use Laravel\Telescope\Telescope;

class UserController extends Controller
{
    public function show($id)
    {
        // Telescope अपने आप इस रिक्वेस्ट को रिकॉर्ड करेगा