Beranda>Kode sumber PHP>Kategori lainnya
Unduh

Orbiter satelit 



                       
                     ?️
                   ·          
                · 
     ?️?️️   ·
    ?️?️   ·  ·  · ?️
     ?️?️️

Kerangka kerja Event & Middleware yang mudah digunakan, ditenagai oleh pemulihan mikro populer dan berdasarkan PSR.

  • Pengaturan
    • Konfigurasi
  • PSR yang diimplementasikan
  • Paket
  • Unduh Build
  • Lisensi

Mendukung PHP 8.1+ dan komposer

Tl; dr

Loncatan cepat ke pengembangan: 

composer create-project orbiter/satellite-app ./satellite

cd ./satellite

# create `.env` file, 
# add for local-dev: `env=local`
touch .env 

# start PHP Dev Server
cd web && php -S localhost:3333 ./index.php display_errors=0

# or point the Apache Root to `/web/`
# or point the NGINX entry to `/web/index.php`
# or use Docker: `docker-compose up`

Buka browser Anda di: http: // localhost: 3333

Lihatlah file:

  • folder config dengan konfigurasi aplikasi dan kabel
  • AutOLoad komposer assemble.php , mengumpulkan konfigurasi dan membuat modul sistem dari konfigurasi itu
  • launch.php menjalankan assemble() dan mengirimkan acara SatelliteApp
  • Folder app dengan Perintah Dasar dan Struktur Penangan Rute

Pengaturan

Instal skeleton aplikasi dan dependensi dengan komposer dalam satellite folder: 

 # with composer installed on machine:
composer create-project orbiter/satellite-app satellite

# with composer and docker on windows:
docker run -it --rm -v %cd%/satellite:/app composer create-project orbiter/satellite-app .
docker run -it --rm -v %cd%/satellite:/app composer create-project --stability=dev orbiter/satellite-app:dev-master .

# with composer and docker on unix:
docker run -it --rm -v ` pwd ` /satellite:/app composer create-project orbiter/satellite-app .
docker run -it --rm -v ` pwd ` /satellite:/app composer create-project --stability=dev orbiter/satellite-app:dev-master .

# go into project folder:
cd ./satellite

Jalankan dengan:

  • Linux, server php dev
  • Command-line PHP
  • Docker, Docker-Compose
  • Server web

Linux, server php dev

Mengatur hak pengguna yang benar, lalu mulai dan buka http: // localhost: 3333 

chmod +x start.sh

./start.sh

Command-line PHP

Mengeksekusi perintah yang ditentukan. 

php cli < command > < ..attr > < ..b >

Docker, Docker-Compose

Termasuk DockerFile PHP yang dapat dikonfigurasi dengan:

  • PHP 8.1
    • dengan FPM dan beberapa ekstensi
    • Menggunakan kembali FPM untuk gambar pekerja CLI yang bersih
  • Opcache
  • PostgreSQL Client Libs (menggunakan pdo )
  • Gambar dasar nginx untuk perutean lokal
  • Kustomisasi di DockerFile
  • Gambar siap yang lebih "produksi", yang dikonfigurasikan sebelumnya untuk membangun dalam CI dengan kompose docker-prod.yml

Untuk konfigurasi gambar Docker lihat file di _docker dan _nginx .

Mulai wadah yang ditentukan dalam docker-compose.yml , lalu buka: http: // localhost: 3333 

docker-compose up

# open shell in app container
docker-compose exec app sh

# run command in temporary worker container
docker-compose run --rm worker php cli demo

# run extra composer container on windows:
docker run -it --rm -v %cd%:/app composer dumpautoload
# run extra composer container on unix:
docker run -it --rm -v ` pwd ` :/app composer dumpautoload

# run tests with temporary `app` container:
docker-compose run -T --rm app sh -c " cd /var/www/html && ./vendor/bin/phpunit --testdox tests "

# running tests with a temporary `phpunit` in a prebuild container:
docker run -i --rm bemiteu/satellite-app:master sh -c " cd /var/www && wget -O phpunit https://phar.phpunit.de/phpunit-9.phar && chmod +x phpunit && cd html && /var/www/phpunit --testdox tests "

Server web

Pada server web, file web/index.php berfungsi sebagai titik masuk publik.

Apache: point server /vhost root ke /web dan gunakan .htaccess yang disertakan

Nginx : Contoh file di _nginx.

Konfigurasi

Gunakan misalnya .env untuk menambahkan konfigurasi.

Konfigurasi Default Termasuk:

  • Env var env : jika dalam produksi atau tidak dalam produksi
    • dengan nilai prod itu diasumsikan dalam aplikasi (bukan kerangka kerja) yang sedang diproduksi
    • Gunakan $_ENV['env'] === 'prod' untuk memeriksa produksi
    • Untuk halaman dev-error: tambahkan var dev.editor dengan satu nilai PrettyPageHandler::EDITOR_* untuk menautkan whoops "buka file" dengan IDE
  • /config/config.php - konfigurasi utama
    • Mengkonfigurasi file konfigurasi lainnya yang disertakan
    • agregat dan cache konfigurasi untuk penggunaan produksi
  • /config/dependencies.php - Definisi untuk php -di
  • /config/events.php - Tentukan aliran komponen aplikasi
  • /config/pipeline.php - Setup PSR Middlewares dan Pipeline

Psrs

Aplikasi ini berfungsi sebagai kerangka kerja mini, dengan perpustakaan bertenaga PSR, anotasi siap pakai dan tidak lebih.

Ini dibangun di atas PSR dan paket khusus yang populer yang menerapkannya atau hal -hal hebat lainnya.

  • PSR -3 - Logger
    • ? monolog/monolog
    • lebih banyak implementasi
  • PSR -4 - Kelas Autoload dan lupa require_once
    • ditangani oleh komposer, lebih banyak dalam dokumen komposer.
  • PSR -1,12 - Panduan Gaya Kode
    • Kecuali aturan lokasi braket: garis yang sama, bukan baris berikutnya untuk membuka {
  • PSR -6 - Cache
    • ? cache/filesystem-adapter
    • Termasuk FilesystemCachePoolNormalized untuk DoctrineCommonAnnotationsPsrCachedReader kompatibilitas
    • lebih banyak implementasi
  • PSR -7 - Pesan HTTP
    • ? nyholmpsr7
    • Definisi Data Permintaan dan Respons
    • Digunakan lebih lanjut oleh PSR-15 , PSR-17 dan PSR-18
  • PSR -11 - Wadah untuk Interop
    • ? php-di/php-di
    • wadah layanan untuk kemudahan dan modularitas
    • Injeksi ketergantungan dengan @Annotations , @var phpdoc dan dukungan refleksi
  • PSR -14 - Dispatcher dan pendengar acara
    • ? orbiter/satellite
    • Sebagai inti dari bagaimana hal -hal disatukan
  • PSR -15 - Penangan HTTP
    • ? orbiter/satellite-response
    • menangani permintaan rute dengan pipa middleware yang kuat
  • PSR -16 - cache sederhana
    • ? cache/filesystem-adapter
    • lebih banyak implementasi
  • PSR -17 - Pabrik HTTP
    • ? nyholmpsr7
    • konteks tentang permintaan
    • Untuk inisiasi permintaan & respons
  • PSR -18 - Klien HTTP
    • ? guzzlehttp/guzzle
    • Kirim permintaan ke API lain
    • lebih banyak implementasi

? = Termasuk dalam template satellite-app

Paket

  • orbiter/satellite
    • mengimplementasikan PSR-14 Event Dispatcher dan pendengar
    • Dengan Invoker untuk mengeksekusi apa pun, PSR-11 kompatibel
    • Profil Berbasis Acara Opsional
    • Lihat Repositori Paket
  • orbiter/satellite-console
    • eksekusi konsol
    • Anotasi Perintah Konsol
    • menggunakan getopt-php
    • Lihat Repositori Paket
  • orbiter/satellite-response
    • Eksekusi Pipa Middleware
    • Menerapkan PSR-15 melalui equip/dispatch , PSR-11 sesuai
    • Implements PSR-7,17 hingga nyholm/psr7 dan nyholm/psr7-server
    • dengan emitor sederhana oleh narrowspark/http-emitter
    • Lihat Repositori Paket
  • orbiter/satellite-route
    • rute dengan anotasi
    • menggunakan nikic/rute cepat sebagai router
    • Dibuat untuk penggunaan middleware PSR, tetapi tidak terbatas
    • Lihat Repositori Paket
  • orbiter/annotations-util
    • Anotasi dengan doctrine/annotations dengan refleksi yang di -cache
    • Dapatkan kelas, metode, dan properti yang dijelaskan
    • Lihat Anotasi
  • orbiter/satellite-whoops
    • Tampilan kesalahan whoops untuk CLI dan rute
    • Hanya ketika $_ENV['env'] tidak prod (dapat dikonfigurasi di assemble.php )
  • orbiter/satellite-config
    • agregator konfigurasi sederhana dengan caching
    • Lihat Repositori Paket
  • orbiter/satellite-launch
    • Objek Data Acara SatelliteApp
    • Lihat Repositori Paket
  • orbiter/satellite-system
    • Pengaturan sistem dan kawat inti, misalnya dari $config ke wadah PSR yang di-cache
    • Lihat Repositori Paket

Banyak pekerjaan untuk API dilakukan oleh Middleware HTTP PSR-15, temukan lebih banyak tiddware yang luar biasa.

Unduh Build

Tidak ada versi yang dapat diunduh - lihat Pengaturan tentang Cara Menginstal dengan Composer.

Kami menggunakan komposer sebagai manajer paket, seperti dalam proyek PHP modern apa pun.

Jangan ragu untuk menjangkau permintaan pelatihan.

Lisensi

Proyek ini adalah perangkat lunak gratis yang didistribusikan di bawah lisensi MIT .

Kontributor

Dengan melakukan kode Anda ke repositori kode, Anda setuju untuk melepaskan kode di bawah lisensi MIT yang dilampirkan ke repositori.

Dikelola oleh Michael Becker

Memperluas
Informasi Tambahan
Aplikasi Terkait
Direkomendasikan untuk Anda
Informasi Terkait Semua