ServBay में ThinkPHP 8 प्रोजेक्ट बनाएं और चलाएं

यह लेख बताएगा कि आप ServBay जैसे पावरफुल लोकल वेब डेवेलपमेंट एनवायरनमेंट का इस्तेमाल करके ThinkPHP 8 फ्रेमवर्क पर आधारित PHP प्रोजेक्ट को कैसे जल्दी बनाएं, कॉन्फ़िगर करें और चलाएं। ServBay आपको पहले से तैयार PHP एनवायरनमेंट, वेब सर्वर (Caddy या Nginx) और कई तरह के डेटाबेस देकर ThinkPHP प्रोजेक्ट का लोकल सेटअप बहुत आसान बना देता है।

ThinkPHP क्या है?

ThinkPHP चीन में बना एक ओपन सोर्स, तेज़ और आसान ऑब्जेक्ट-ओरिएंटेड PHP डेवेलपमेंट फ्रेमवर्क है। यह सिंपल और एफिशिएंट डेवेलपमेंट प्रिंसिपल्स को फॉलो करता है और डेवलपर्स को मॉडर्न वेब ऐप्लिकेशन बनाने के लिए सुविधाजनक टूल्स देता है। ThinkPHP अपनी इस्तेमाल में आसानी, मजबूत फीचर्स (जैसे पावरफुल ORM, लचीला रूटिंग, इंटरनल टेम्प्लेट इंजन, कैशिंग आदि) और एक्टिव कम्युनिटी की वजह से चीन में PHP डेवेलपमेंट का बेहद लोकप्रिय टूल है।

ThinkPHP की मुख्य विशेषताएं और फायदे

• सिंपल और एफिशिएंट: फ्रेमवर्क का डिज़ाइन क्लीयर और स्ट्रक्चर्ड है, जिससे इसे समझना और मेंटेन करना आसान है, और डेवेलपमेंट फास्ट होती है।
• फीचर्स से भरा: इनमें Web डेवेलपमेंट के लिए जरूरी MVC स्ट्रक्चर, ORM, टेम्प्लेट इंजन, कैशिंग, सेशन मैनेजमेंट, ऑथेंटिकेशन, फॉर्म टोकन आदि शामिल हैं।
• मजबूत ORM: आसान और शक्तिशाली ऑब्जेक्ट-रिलेशनल मैपिंग सपोर्ट, जो डेटाबेस ऑपरेशंस को सिंपल बनाता है।
• फ्लेक्सिबल रूटिंग: कई तरह की रूटिंग डिफाइनेशन का सपोर्ट, जिससे जटिल URL स्ट्रक्चर संभाले जा सकते हैं।
• समृद्ध ईकोसिस्टम: बहुत सारे एक्सटेंशन, प्लगिन्स और बड़ी एक्टिव डेवेलपर कम्युनिटी — जिससे संसाधनों की कोई कमी नहीं।
• निरंतर अपडेट: फ्रेमवर्क वर्ज़न जल्दी-जल्दी अपडेट होते हैं, ताकि ये PHP और वेब डेवेलपमेंट की लेटेस्ट ट्रेंड्स के साथ बना रहे।

ThinkPHP छोटे प्रोजेक्ट्स से लेकर बड़े एंटरप्राइज़ वेब डेवेलपमेंट तक हर स्तर के लिए उपयुक्त है।

ServBay का उपयोग करके ThinkPHP 8 प्रोजेक्ट सेटअप करें

ServBay आपके ThinkPHP 8 प्रोजेक्ट के लिए आदर्श लोकल डेवेलपमेंट वातावरण देता है, जिसमें:

• कई वर्शन के PHP और जरूरी एक्सटेंशन्स पहले से इंस्टॉल्ड।
• इनबिल्ट वेब सर्वर (Caddy या Nginx), वेबसाइट्स को सेटअप करना बेहद आसान।
• MySQL, PostgreSQL, MongoDB, Redis, Memcached समेत कई डेटाबेस सेवाएँ।
• इनबिल्ट Composer डिपेंडेंसी मैनेजर।

इस गाइड में ServBay की इन्हीं सुविधाओं का इस्तेमाल करते हुए आपके लिए ThinkPHP 8 प्रोजेक्ट जल्दी और आसान तरीके से सेटअप किया जाएगा।

आवश्यक शर्तें

शुरू करने से पहले निम्नलिखित तैयारियाँ पूरी कर लें:

1. आपने macOS पर ServBay डाउनलोड और इंस्टॉल कर लिया है।
2. ServBay चल रहा है, और आपकी आवश्यक PHP वर्शन (ThinkPHP 8 के लिए PHP 8.0 या अधिक), साथ ही ज़रूरी डेटाबेस सेवाएँ (जैसे MySQL, PostgreSQL, Redis, Memcached आदि) चालू हैं। ServBay के कंट्रोल पैनल में "सॉफ्टवेयर पैकेज" टैब में इन्हें देखें और स्टार्ट करें।

ThinkPHP प्रोजेक्ट बनाएं

ServBay अनुशंसा करता है कि आप अपनी सभी लोकल वेबसाइट फ़ाइलें /Applications/ServBay/www फोल्डर में रखें, जिससे ServBay वेबसाइट मैनेजमेंट बेहतर कर पाता है।

1. Composer इंस्टॉल होना कन्फर्म करें

   ServBay इंस्टॉल करते वक्त Composer प्री-इंस्टॉल्ड आता है। आमतौर पर अलग से इंस्टॉल करने की जरूरत नहीं। आप ServBay टर्मिनल में composer --version चलाकर चेक करें।

2. Composer से ThinkPHP प्रोजेक्ट बनाएं

   macOS टर्मिनल खोलें, और ये कमांड चलाएँ — इससे ServBay वेबसाइट रूट डायरेक्टरी में नया ThinkPHP 8 प्रोजेक्ट बन जाएगा:

   cd /Applications/ServBay/www
   composer create-project topthink/think servbay-thinkphp-app

   यह /Applications/ServBay/www डायरेक्ट्री में servbay-thinkphp-app नाम का नया फ़ोल्डर बनाता है और ThinkPHP 8 की जरूरी फाइलें डाउनलोड करता है।

3. प्रोजेक्ट डायरेक्ट्री में जाएं

   प्रोजेक्ट बन जाने के बाद इस कमांड से अंदर जाएँ:

   cd /Applications/ServBay/www/servbay-thinkphp-app

प्रोजेक्ट कॉन्फ़िगरेशन इनिशियलाइज़ करें

प्रोजेक्ट बनने के बाद कुछ बेसिक सेटिंग करनी होती है।

1. डेटाबेस कनेक्शन सेट करें

   ThinkPHP का डेटाबेस सेटअप आमतौर पर config/database.php फाइल में होता है। ServBay में जो डेटाबेस चला हुआ हो उसके अनुसार इसमें सही कनेक्शन जानकारी भरें।

   नीचे ServBay के डिफ़ॉल्ट MySQL सर्वर के लिए एक उदाहरण:

   <?php
   // config/database.php
   
   return [
       // डिफ़ॉल्ट डेटाबेस कनेक्शन सेटिंग
       'default'         => env('database.driver', 'mysql'),
   
       // अलग-अलग डेटाबेस कनेक्शन
       'connections'     => [
           'mysql' => [
               // डेटाबेस टाइप
               'type'     => 'mysql',
               // सर्वर एड्रेस
               'hostname' => env('database.hostname', '127.0.0.1'),
               // डेटाबेस नाम
               'database' => env('database.database', 'servbay_thinkphp_app'), // प्रोजेक्ट के लिए अलग डेटाबेस बनाएं
               // यूजरनेम
               'username' => env('database.username', 'root'),
               // पासवर्ड
               'password' => env('database.password', 'password'), // ServBay का डिफ़ॉल्ट पासवर्ड, सिर्फ लोकल में यूज़ करें!
               // पोर्ट
               'hostport' => env('database.hostport', '3306'),
               // ... अन्य सेटिंग ...
           ],
           // ... अन्य डेटाबेस कनेक्शन ...
       ],
   ];

   महत्वपूर्ण सूचना:

   • database के मान को अपने बनाए हुए प्रोजेक्ट के डेटाबेस नाम से बदलें (जैसे ServBay के phpMyAdmin या Adminer में servbay_thinkphp_app नाम से नया डेटाबेस बनाएं)।
   • ServBay में डिफ़ॉल्ट root पासवर्ड password होता है। सिर्फ लोकल डेवेलपमेंट में ही यूज करें, प्रोडक्शन में कभी नहीं! प्रोडक्शन के लिए स्ट्रॉंग पासवर्ड और लॉउएस्ट परमिशन वाले यूजर का ही उपयोग करें।
   • अगर आप .env फाइल से एनवायरनमेंट वेरिएबल्स मैनेज करते हैं तो वहाँ की सेटिंग्स आपकी config/database.php के डिफ़ॉल्ट को ओवरराइड करेंगी।

वेब सर्वर सेटअप

ThinkPHP फ्रेमवर्क की एंट्री फाइल public/index.php है और इसमें रूटिंग के लिए URL रीराइटिंग जरूरी है। ThinkPHP की रूटिंग आम स्टैटिक फाइल्स से अलग है, इसलिए ServBay के इनबिल्ट रीराइट नियम का इस्तेमाल करें।

वेबसाइट सेटिंग पेज पर रीराइट नियम वाले ड्रॉपडाउन से ThinkPHP चुनें और सेव करें।

डिटेल्ड वेबसाइट सेटिंग स्टेप्स के लिए देखें: अपनी पहली वेबसाइट जोड़ें।

उदाहरण कोड जोड़ें

वेबसाइट सेटअप सही है या नहीं, और ThinkPHP रूटिंग चल रही है या नहीं, यह चेक करने के लिए हम एक सिंपल रूट और कंट्रोलर जोड़ते हैं।

अपनी प्रोजेक्ट फाइल /Applications/ServBay/www/servbay-thinkphp-app/route/app.php एडिट करें और नीचे दिया कोड डालें — यह एक सिंपल GET रूट बनाएगा:

<?php
// route/app.php

use think\facade\Route;

// 'servbay' नाम से रूट बनाएं, /servbay पर पहुँचने पर यह फंक्शन चलेगा
Route::get('servbay', function () {
    return 'Hello ServBay!';
});

// ... अन्य रूट ...

वेबसाइट पर जाएं

ऊपर के सभी स्टेप्स पूरे होने के बाद, अपने वेब ब्राउज़र में वह लोकल डोमेन और ऊपरी उदाहरण रूट खोलें:

https://thinkphp.servbay.demo/servbay

अगर सब कुछ ठीक से किया है, तो ब्राउज़र में मिलेगा: Hello ServBay!
इसका मतलब आपका ThinkPHP 8 प्रोजेक्ट ServBay के लोकल वातावरण में सफलतापूर्वक चल गया है, और सर्वर व PHP-FPM दोनों की सेटिंग सही है।

NoSQL डेटाबेस उदाहरण

ServBay में कई NoSQL डेटाबेस जैसे Memcached और Redis पहले से इंस्टॉल्ड रहते हैं। ThinkPHP अपने कैशिंग लेयर से इन्हें बहुत आसानी से सपोर्ट करता है।

Memcached उदाहरण

1. Memcached एक्सटेंशन का इंस्टॉल होना कन्फर्म करें

   ServBay में PHP के पैकेज में Memcached पहले से ही होता है। "सॉफ्टवेयर पैकेज" टैब में जाकर Memcached सर्विस चालू देखें।

2. Memcached को कैशिंग में सेट करें

   config/cache.php फाइल एडिट करें, ताकि ThinkPHP Memcached को कैश ड्राइवर के रूप में ले:

   <?php
   // config/cache.php
   
   return [
       // डिफ़ॉल्ट कैश ड्राइवर
       'default' => env('cache.driver', 'memcached'),
   
       // कैश स्टोर कॉन्फिग
       'stores'  => [
           'memcached' => [
               // कैश टाइप
               'type'       => 'memcached',
               // सर्वर लिस्ट
               'host'       => '127.0.0.1', // ServBay Memcached डिफ़ॉल्ट ऐड्रेस
               'port'       => 11211, // ServBay Memcached डिफ़ॉल्ट पोर्ट
               'persistent' => false,
               'expire'     => 0,
               'timeout'    => 0,
               'prefix'     => '',
           ],
           // ... अन्य कैश सेटिंग ...
       ],
   ];

3. कोड में Memcached कैश यूज़ करें

   अपने कंट्रोलर या रूट कोलबैक में ThinkPHP के Cache को यूज़ करें:

   <?php
   use think\facade\Cache;
   use think\facade\Route;
   
   Route::get('/memcached-example', function () {
       // कैश सेट करें, वैधता 600 सेकंड
       Cache::set('my_memcached_key', 'This value is from Memcached!', 600);
   
       // कैश प्राप्त करें
       $value = Cache::get('my_memcached_key');
   
       return 'Value from Memcached: ' . $value;
   });

   इसे टेस्ट करने के लिए खोलें: https://thinkphp.servbay.demo/memcached-example

Redis उदाहरण

1. Redis एक्सटेंशन का इंस्टॉल होना कन्फर्म करें

   ServBay के PHP पैकेज में Redis एक्सटेंशन भी प्रीइंस्टॉल्ड है। "सॉफ्टवेयर पैकेज" टैब में Redis सर्विस चालू है यह देखें।

2. Redis को कैशिंग में सेट करें

   config/cache.php में ThinkPHP को Redis कैश ड्राइवर पर सेट करें:

   <?php
   // config/cache.php
   
   return [
       // डिफ़ॉल्ट कैश ड्राइवर
       'default' => env('cache.driver', 'redis'),
   
       // कैश स्टोर कॉन्फिग
       'stores'  => [
           'redis' => [
               // कैश टाइप
               'type'       => 'redis',
               // सर्वर ऐड्रेस
               'host'       => env('cache.host', '127.0.0.1'), // ServBay Redis डिफ़ॉल्ट ऐड्रेस
               // पोर्ट
               'port'       => env('cache.port', 6379), // ServBay Redis डिफ़ॉल्ट पोर्ट
               // पासवर्ड (ServBay डिफ़ॉल्ट में कोई पासवर्ड नहीं)
               'password'   => env('cache.password', ''), // ServBay Redis में पासवर्ड नहीं
               'select'     => 0,
               'timeout'    => 0,
               'expire'     => 0,
               'persistent' => false,
               'prefix'     => '',
           ],
           // ... अन्य कैश सेटिंग ...
       ],
   ];

   ध्यान दें: ServBay में Redis डिफ़ॉल्ट में पासवर्ड से सुरक्षित नहीं होता। अगर आपने हाथ से Redis का पासवर्ड सेट किया है, तो यहां पासवर्ड फ़ील्ड अपडेट कर दें।

3. कोड में Redis कैशिंग का इस्तेमाल करें

   ThinkPHP के Cache फ़ैसाड का प्रयोग करें:

   <?php
   use think\facade\Cache;
   use think\facade\Route;
   
   Route::get('/redis-example', function () {
       // कैश सेट करें, डिफ़ॉल्ट रूप से स्थायी (या थर्ड पैरामीटर से वैधता तय करें)
       Cache::set('my_redis_key', 'Hello from Redis!');
   
       // कैश लें
       $value = Cache::get('my_redis_key');
   
       return 'Value from Redis: ' . $value;
   });

   इसे टेस्ट करें: https://thinkphp.servbay.demo/redis-example

रिलेशनल डेटाबेस उदाहरण

ServBay में MySQL और PostgreSQL जैसे प्रमुख रिलेशनल डेटाबेस सॉल्यूशन्स शामिल हैं। ThinkPHP का ORM इन डेटाबेस के साथ काम करना बहुत आसान बना देता है।

ThinkPHP डेटाबेस माइग्रेशन टूल का उपयोग करें

ThinkPHP प्रोजेक्ट में डेटा स्ट्रक्चर बदलने के लिए माइग्रेशन टूल का प्रयोग करें — इससे टीम वर्ज़निंग और कोलैबोरेशन आसान होता है।

1. माइग्रेशन टूल इंस्टॉल करें

   प्रोजेक्ट के रूट में ThinkPHP माइग्रेशन एक्सटेंशन Composer से इंस्टॉल करें:

   cd /Applications/ServBay/www/servbay-thinkphp-app
   composer require topthink/think-migration

2. माइग्रेशन फाइल बनाएं

   कमांड लाइन से एक नई माइग्रेशन फाइल जेनेरेट करें (उदाहरण: users टेबल बनाने के लिए):

   php think migrate:create CreateUserTable

   इससे आपके database/migrations फोल्डर में एक PHP फ़ाइल बनेगी जिसका नाम टाइमस्टैम्प और आपके चुने नाम से बनेगा (जैसे 20231027100000_create_user_table.php)।

3. माइग्रेशन फाइल एडिट करें

   नई बनी फाइल में up() या change() मेथड में users टेबल की संरचना डालें:

   <?php
   // database/migrations/YYYYMMDDHHMMSS_create_user_table.php
   
   use think\migration\Migrator;
   use think\migration\db\Column;
   
   class CreateUserTable extends Migrator
   {
       /**
        * Change Method.
        *
        * Write your reversible migrations using this method.
        *
        * More information on writing migrations is available here:
        * http://docs.phinx.org/en/latest/migrations.html#the-change-method
        *
        * The following commands can be used in this method and Phinx will
        * automatically reverse them when rolling back:
        *
        * createTable
        * renameTable
        * addColumn
        * addCustomColumn
        * renameColumn
        * addIndex
        * addForeignKey
        * createDatabase
        * renameDatabase
        * dropTable
        * dropColumn
        * dropIndex
        * dropForeignKey
        */
       public function change()
       {
           // createTable मेथड की मदद से टेबल बनाएं
           $table = $this->table('users');
           $table->addColumn('name', 'string', ['limit' => 50, 'comment' => 'यूज़र का नाम'])
                 ->addColumn('email', 'string', ['limit' => 100, 'comment' => 'ईमेल पता'])
                 ->addIndex(['email'], ['unique' => true]) // यूनिक इंडेक्स डालें
                 ->addTimestamps() // created_at और updated_at कॉलम डालें
                 ->create(); // क्रिएट करें
       }
   
       // अगर change का इस्तेमाल नहीं करना चाहते, तो up() और down() अलग लिख सकते हैं
       /*
       public function up()
       {
           $table = $this->table('users');
           $table->addColumn('name', 'string', ['limit' => 50, 'comment' => 'यूज़र का नाम'])
                 ->addColumn('email', 'string', ['limit' => 100, 'comment' => 'ईमेल पता'])
                 ->addIndex(['email'], ['unique' => true])
                 ->addTimestamps()
                 ->create();
       }
   
       public function down()
       {
           $this->dropTable('users');
       }
       */
   }

4. माइग्रेशन रन करें

   ServBay के टर्मिनल में प्रोजेक्ट रूट पर रहें और ये कमांड रन करें:

   php think migrate:run

   सफल होने पर आपके डेटाबेस में नया users टेबल बन जाएगा।

MySQL उदाहरण

मान लीजिए आपने ServBay में MySQL चालू किया और config/database.php में MySQL कनेक्शन सेट किया (जैसा कि ऊपर बताया गया है)।

1. MySQL कनेक्शन सेट करें

   ऊपर "प्रोजेक्ट कॉन्फिग शुरू करें" वार्तालाप देखें और सुनिश्चित करें कि config/database.php में जानकारी सही है।

2. कोड में डेटा डालें

   ThinkPHP के Db फ़ैसाड या ORM से डेटा डालें। उदाहरण — (यहाँ Db फ़ैसाड का प्रयोग):

   <?php
   use think\facade\Db;
   use think\facade\Route;
   
   Route::get('/mysql-add-user', function () {
       try {
           Db::table('users')->insert([
               'name' => 'ServBay Demo User',
               'email' => '[email protected]', // ब्रांड नाम से उदाहरण ईमेल
               'created_at' => date('Y-m-d H:i:s'), // अगर addTimestamps() ऑटो-पॉपुलेट नहीं करता
               'updated_at' => date('Y-m-d H:i:s'),
           ]);
           return 'User added successfully!';
       } catch (\Exception $e) {
           return 'Error adding user: ' . $e->getMessage();
       }
   });

   ट्राई करें: https://thinkphp.servbay.demo/mysql-add-user

3. कोड में यूज़र डेटा पढ़ें

   Db फ़ैसाड या ORM से डेटा पढ़ें:

   <?php
   use think\facade\Db;
   use think\facade\Route;
   
   Route::get('/mysql-users', function () {
       $users = Db::table('users')->select(); // सभी यूज़र डेटा लें
       return json($users); // JSON के रूप में लौटाएँ
   });

   इसे खोलें: https://thinkphp.servbay.demo/mysql-users

PostgreSQL उदाहरण

मान लीजिए आपने PostgreSQL चालू किया और सही तरीके से config/database.php में सेट किया है।

1. PostgreSQL कनेक्शन सेट करें

   config/database.php में यह जोड़ें (या अपने सेटअप के हिसाब से एडिट करें):

   <?php
   // config/database.php (आंशिक)
   
   return [
       // ... अन्य सेटिंग ...
   
       'connections'     => [
           // ... MySQL सेटिंग ...
   
           'pgsql' => [
               // डेटाबेस टाइप
               'type'     => 'pgsql',
               // सर्वर ऐड्रेस
               'hostname' => env('database.hostname', '127.0.0.1'),
               // डेटाबेस नाम
               'database' => env('database.database', 'servbay_thinkphp_app'), // प्रोजेक्ट के लिए अलग डेटाबेस बनाएं
               // यूज़रनेम
               'username' => env('database.username', 'root'),
               // पासवर्ड
               'password' => env('database.password', 'password'), // ServBay डिफ़ॉल्ट पासवर्ड, सिर्फ लोकल डेवेलपमेंट के लिए!
               // पोर्ट
               'hostport' => env('database.hostport', '5432'), // PostgreSQL डिफ़ॉल्ट पोर्ट
               // ... अन्य सेटिंग ...
           ],
           // ... अन्य डेटाबेस कनेक्शन ...
       ],
   ];

   महत्वपूर्ण निर्देश:

   • MySQL की तरह ही, प्रोजेक्ट के लिए एक अलग PostgreSQL डेटाबेस बनाएं और उसका नाम यहाँ डालें।
   • ServBay के PostgreSQL में भी root का पासवर्ड डिफ़ॉल्ट password है — सिर्फ लोकल यूज के लिए।

2. कोड से डेटा डालें

   ThinkPHP Db फ़ैसाड या ORM से डेटा डालें — साथ ही pgsql कनेक्शन यूज़ करना न भूलें:

   <?php
   use think\facade\Db;
   use think\facade\Route;
   
   Route::get('/pgsql-add-user', function () {
       try {
           Db::connect('pgsql')->table('users')->insert([
               'name' => 'ServBay PgSQL User',
               'email' => '[email protected]', // ब्रांड ईमेल
               // टाइमस्टैम्प अगर माइग्रेशन या ThinkPHP वर्शन के कारण मैन्युअली डालना पड़े तो
               'created_at' => date('Y-m-d H:i:s'),
               'updated_at' => date('Y-m-d H:i:s'),
           ]);
           return 'PostgreSQL User added successfully!';
       } catch (\Exception $e) {
            return 'Error adding PostgreSQL user: ' . $e->getMessage();
       }
   });

   ट्राई करें: https://thinkphp.servbay.demo/pgsql-add-user

3. कोड से डेटा पढ़ें

   Db फ़ैसाड का प्रयोग करें — याद रखें कि connect('pgsql') बताना जरूरी है:

   <?php
   use think\facade\Db;
   use think\facade\Route;
   
   Route::get('/pgsql-users', function () {
       $users = Db::connect('pgsql')->table('users')->select(); // pgsql से डेटा लें
       return json($users); // JSON में लौटाएँ
   });

   खोलें: https://thinkphp.servbay.demo/pgsql-users

निष्कर्ष

ऊपर दिए गए सभी स्टेप्स को फॉलो करने के बाद, आपने ServBay लोकल डेवेलपमेंट एनवायरनमेंट में ThinkPHP 8 प्रोजेक्ट को सफलतापूर्वक सेटअप, कॉन्फ़िगर और रन कर लिया। आपने ServBay के इनबिल्ट Composer से प्रोजेक्ट बनाना, Caddy वेब सर्वर में ThinkPHP की रूटिंग सेट करना, और MySQL, PostgreSQL, Memcached, Redis आदि के साथ काम करना सीख लिया।

ServBay की मदद से आपका PHP फ्रेमवर्क आधारित लोकल डेवेलपमेंट बहुत आसान हो जाता है, जिससे आप कोडिंग और बिज़नेस लॉजिक पर फोकस रख सकते हैं। अब आगे आप अपनी ThinkPHP वेबसाइट डेवेलपमेंट पूरी गति से जारी रखें और ServBay के सॉफ्टवेयर पैकेजेस और फीचर्स का भरपूर फायदा उठाएँ!