caddy php

تحكم في مثيل العلبة الخاص بك من خلال PHP

هذا هو أكثر من دليل على المفهوم وليس مشروع العمل بالكامل. هذا يحاول تكرار بنية API Caddy JSON للعمل من خلال فصول PHP القابلة للسلسلة.

في الوقت الحالي ، لا يوجد سوى مجموعة فرعية صغيرة من الأوامر المتاحة من Caddy 2.0 والتي غطت حالة الاستخدام التي تحتاجها حاليًا.

ثَبَّتَ

composer require mattvb91/caddy-php

الاستخدام الأساسي

مثال أساسي لخادم HTTP مع استجابة ثابتة:

 $ caddy = new Caddy ();

$ caddy -> addApp (
    ( new Http ())-> addServer (
        ' server1 ' , ( new Http  Server ())-> addRoute (
        ( new Route ())-> addHandle (
            new StaticResponse ( ' Hello world ' , 200 )
        )
    ))
);

$ caddy -> load ();

سيؤدي هذا إلى تكوين العلبة التالي:

{
  "admin" : {
    "disabled" : false ,
    "listen" : " :2019 "
  },
  "apps" : {
    "http" : {
      "servers" : {
        "server1" : {
          "listen" : [
            " :80 "
          ],
          "routes" : [
            {
              "handle" : [
                {
                  "handler" : " static_response " ,
                  "body" : " Hello world " ,
                  "status_code" : 200
                }
              ]
            }
          ]
        }
      }
    }
  }
}

curl -v localhost

-----
< HTTP/1.1 200 OK
< Server: Caddy
Hello world       

إدارة أسماء المضيف

إذا كنت تقوم بإدارة أسماء المضيف ديناميكيًا (في قاعدة بيانات) ولا يمكنك إنشاء التكوين مع قائمة أسماء المضيف الموجودة لأنك تحتاج إلى إدارتها في وقت التشغيل ، يمكنك القيام بما يلي:

الجزء المهم في هذا المثال هو معرف host_group_name الذي يستخدم لاحقًا لإضافة / إزالة المجالات إلى هذا المضيف.

 $ caddy = new Caddy ();
$ caddy -> addApp (
    ( new Http ())-> addServer (
        ' server1 ' , ( new Http  Server ())-> addRoute (
        ( new Route ())-> addHandle (
            new StaticResponse ( ' host test ' , 200 )
        )-> addMatch (( new Host ( ' host_group_name ' ))
            -> setHosts ([ ' localhost ' ])
        )
    )-> addRoute (( new Route ())
        -> addHandle ( new StaticResponse ( ' Not found ' , 404 ))
        -> addMatch (( new Host ( ' notFound ' ))
            -> setHosts ([ ' *.localhost ' ])
        )
    ))
);
$ caddy -> load ();

إضافة أسماء المضيف

الآن في وقت لاحق في برنامج نصي أو حدث على نظامك ، يمكنك الحصول على كائن تكوين Caddy الخاص بك ونشر مجال جديد إليه تحت هذا المسار:

 $ caddy -> addHostname ( ' host_group_name ' , ' new.localhost ' )
$ caddy -> addHostname ( ' host_group_name ' , ' another.localhost ' )

curl -v new.localhost
> GET / HTTP/1.1
> Host: new.localhost
> 
< HTTP/1.1 200 OK

curl -v another.localhost
> GET / HTTP/1.1
> Host: another.localhost
> 
< HTTP/1.1 200 OK

إزالة أسماء المضيف

 $ caddy -> syncHosts ( ' host_group_name ' ); //Sync from caddy current hostname list

$ caddy -> removeHostname ( ' host_group_name ' , ' new.localhost ' );
$ caddy -> removeHostname ( ' host_group_name ' , ' another.localhost ' );

curl -v new.localhost
> GET / HTTP/1.1
> Host: new.localhost
> 
< HTTP/1.1 404 Not Found

curl -v another.localhost
> GET / HTTP/1.1
> Host: another.localhost
> 
< HTTP/1.1 404 Not Found

مثال متقدم

دعنا نأخذ علبة حيث تريد الحصول على واجهة أمامية للعقدة وتوصيل PHP بطلبات على مسار /api/* . في هذه الحالة ، ينقسم المثال إلى 2 Proxy's عكسي مع مطابقة مسار لتصفية /api/* إلى PHP Upstream.

هذا يفترض أن المضيفين الثلاثة (Caddy ، Node ، PHP) كلها حاويات Docker ويمكن الوصول إليها بواسطة اسم الحاوية داخل شبكة Docker نفسها ، لذلك قد تضطر إلى ضبط أسماء المضيف الخاصة بك كما هو مطلوب.

 use mattvb91  CaddyPhp  Caddy ;
use mattvb91  CaddyPhp  Config  Apps  Http ;
use mattvb91  CaddyPhp  Config  Apps  Http  Server ;
use mattvb91  CaddyPhp  Config  Apps  Http  Server  Route ;
use mattvb91  CaddyPhp  Config  Apps  Http  Server  Routes  Handle  ReverseProxy ;
use mattvb91  CaddyPhp  Config  Apps  Http  Server  Routes  Handle  ReverseProxy  Transport  FastCGI ;
use mattvb91  CaddyPhp  Config  Apps  Http  Server  Routes  Handle  ReverseProxy  Upstream ;
use mattvb91  CaddyPhp  Config  Apps  Http  Server  Routes  Handle  Subroute ;
use mattvb91  CaddyPhp  Config  Apps  Http  Server  Routes  Match  Host ;
use mattvb91  CaddyPhp  Config  Apps  Http  Server  Routes  Match  Path ;

$ apiReverseProxy = ( new ReverseProxy ())
    -> addUpstream (( new Upstream ())
        -> setDial ( ' laravel-api:9000 ' )
    )-> addTransport (( new FastCGI ())
        -> setRoot ( ' /app/public/index.php ' )
        -> setSplitPath ([ '' ])
    );

$ apiMatchPath = ( new Path ())
    -> setPaths ([
        ' /api/* ' ,
    ]);

$ backendAPIRoute = ( new Route ())
    -> addHandle ( $ apiReverseProxy )
    -> addMatch ( $ apiMatchPath );

$ route = new Route ();
$ route -> addHandle (( new Subroute ())
    -> addRoute ( $ backendAPIRoute )
    -> addRoute (( new Route ())
        -> addHandle (( new ReverseProxy ())
            -> addUpstream (( new Upstream ())
                -> setDial ( ' nextjs:3000 ' )
            )
        )
    )
)-> addMatch (( new Host ())
    -> setHosts ([
        ' localhost ' ,
    ])
)-> setTerminal ( true );

$ caddy = new Caddy ();
$ caddy -> addApp (( new Http ())
    -> addServer ( ' myplatform ' , ( new Server ())
        -> addRoute ( $ route )
    )
);
$ caddy -> load ();

هذا سوف ينشر تكوين العلبة التالي:

{
  "admin" : {
    "disabled" : false ,
    "listen" : " :2019 "
  },
  "apps" : {
    "http" : {
      "servers" : {
        "myplatform" : {
          "listen" : [
            " :80 "
          ],
          "routes" : [
            {
              "handle" : [
                {
                  "handler" : " subroute " ,
                  "routes" : [
                    {
                      "handle" : [
                        {
                          "handler" : " reverse_proxy " ,
                          "transport" : {
                            "protocol" : " fastcgi " ,
                            "root" : " /app/public/index.php " ,
                            "split_path" : [
                              " "
                            ]
                          },
                          "upstreams" : [
                            {
                              "dial" : " laravel-api:9000 "
                            }
                          ]
                        }
                      ],
                      "match" : [
                        {
                          "path" : [
                            " /api/* "
                          ]
                        }
                      ]
                    },
                    {
                      "handle" : [
                        {
                          "handler" : " reverse_proxy " ,
                          "upstreams" : [
                            {
                              "dial" : " nextjs:3000 "
                            }
                          ]
                        }
                      ]
                    }
                  ]
                }
              ],
              "match" : [
                {
                  "host" : [
                    " localhost "
                  ]
                }
              ],
              "terminal" : true
            }
          ]
        }
      }
    }
  }
}

curl -v localhost

< HTTP/1.1 200 OK
< Content-Type: text/html ; charset=utf-8
< Server: Caddy
< X-Powered-By: Next.js
< Transfer-Encoding: chunked
< 
< ! DOCTYPE html><html > ....

curl -v localhost/api/testroute

< HTTP/1.1 200 OK
< Content-Type: application/json
< Server: Caddy
< X-Powered-By: PHP/8.1.7
< 
{ " status " :200}

ألقِ نظرة على الاختبارات لمزيد من الأمثلة.