plackupp - Dalam talian di Awan

JADUAL:

NAMA

plackup - Jalankan aplikasi PSGI dengan pengendali Plack

SINOPSIS

# baca apl anda daripada fail app.psgi
plackup

# pilih fail .psgi daripada ARGV[0] (atau dengan pilihan -a)
plackup hello.psgi

# tukar pelaksanaan pelayan dengan --server (atau -s)
plackup --server HTTP::Server::Simple --port 9090 --host 127.0.0.1 test.psgi

# gunakan soket UNIX untuk menjalankan daemon FCGI
plackup -s FCGI --dengar /tmp/fcgi.sock myapp.psgi

# lancarkan pelayan luaran FCGI pada port 9090
plackup -s FCGI --port 9090

DESCRIPTION

plackup ialah utiliti baris arahan untuk menjalankan aplikasi PSGI daripada baris arahan.

plackup secara automatik memikirkan persekitaran ia dijalankan, dan menjalankan aplikasi anda
dalam persekitaran itu. FastCGI, CGI, AnyEvent dan lain-lain semuanya boleh dikesan. Lihat
Plack::Pemuat untuk senarai berwibawa.

"plakkup" menganggap anda mempunyai skrip "app.psgi" dalam direktori semasa anda. Yang terakhir
pernyataan "app.psgi" harus menjadi rujukan kod yang merupakan aplikasi PSGI:

#!/usr/bin/perl
gunakan MyApp;
my $application = MyApp->new;
$app saya = sub { $application->run_psgi(@_)};

HUJAH

.psgi
plackup --host 127.0.0.1 --port 9090 /path/to/app.psgi

Argumen bukan pilihan pertama digunakan sebagai laluan fail ".psgi". Anda juga boleh menetapkan ini
laluan dengan "-a" atau "--app". Jika ditinggalkan, laluan fail lalai ialah "app.psgi" dalam
direktori semasa.

PILIHAN

-a, --app
Menentukan laluan penuh ke skrip ".psgi". Anda boleh memberikan laluan ini secara bergilir-gilir sebagai
hujah pertama untuk "plakup".

-e Menilai kod perl yang diberikan sebagai apl PSGI, sama seperti pilihan "-e" perl:

plackup -e 'sub { my $env = shift; kembali [ ... ] }'

Ia juga berguna apabila anda ingin menjalankan aplikasi tersuai seperti Plack::App::*.

plackup -MPlack::App::File -e 'Plack::App::File->new(...)->to_app'

Anda juga boleh menentukan pilihan "-e" dengan laluan fail ".psgi" untuk membungkus aplikasi dengannya
konfigurasi middleware daripada baris arahan. Anda juga boleh menggunakan Plack::Builder DSL
sintaks di dalam kod "-e". Sebagai contoh:

plackup -e 'dayakan "Auth::Basic", authenticator => ...;' myapp.psgi

adalah bersamaan dengan aplikasi PSGI:

gunakan Plack::Builder;
gunakan Plack::Util;

pembina {
dayakan "Auth::Basic", authenticator => ...;
Plack::Util::load_psgi("myapp.psgi");
};

Ambil perhatian bahawa apabila anda menggunakan pilihan "-e" untuk mendayakan perisian tengah, plackup tidak menganggap
laluan "app.psgi" tersirat. Anda mesti sama ada melepasi laluan ke fail ".psgi" anda dalam fail
argumen baris arahan atau muatkan aplikasi di dalam "-e" selepas "dayakan".

plackup # Menjalankan app.psgi
plackup -e 'dayakan "Foo"' # Tidak berfungsi!
plackup -e 'dayakan "Foo"' app.psgi # Berfungsi
plackup -e 'dayakan "Foo"; sub { ... }' # Berfungsi

-o, --tuan rumah
Mengikat kepada antara muka TCP. Lalai kepada undef, yang membolehkan kebanyakan bahagian belakang pelayan terikat kepada
mana-mana antara muka (*). Pilihan ini hanya sah untuk pelayan yang menyokong TCP
soket.

-p, --port
Mengikat ke port TCP. Lalai kepada 5000. Pilihan ini hanya sah untuk pelayan yang
menyokong soket TCP.

-s, --server, pembolehubah persekitaran "PLACK_SERVER".
Memilih pelaksanaan pelayan khusus untuk dijalankan. Apabila disediakan, "-s" atau
Bendera "--server" akan diutamakan berbanding pembolehubah persekitaran.

Jika tiada pilihan diberikan, plackup akan cuba mengesan terbaik berasaskan pelaksanaan pelayan
pada pembolehubah persekitaran serta modul yang dimuatkan oleh aplikasi anda dalam %INC.
Lihat Plack::Loader untuk butiran.

-S, --soket
Mendengar pada laluan soket domain UNIX. Lalai kepada undef. Pilihan ini hanya sah untuk
pelayan yang menyokong soket UNIX.

-l, --dengar
Mendengar pada satu atau lebih alamat, sama ada "HOST:PORT", ":PORT", atau "PATH" (tanpa
titik bertindih). Anda boleh menggunakan pilihan ini beberapa kali untuk mendengar pada berbilang alamat, tetapi
pelayan akan memutuskan sama ada ia menyokong berbilang antara muka.

-D, --daemonize
Membuat proses berjalan di latar belakang. Terpulang kepada pelayan/pengendali bahagian belakang
pelaksanaan sama ada pilihan ini dihormati atau tidak.

-I Menentukan perpustakaan Perl termasuk laluan, seperti pilihan -I "perl". Anda boleh menambah berbilang
laluan dengan menggunakan pilihan ini beberapa kali.

-M Memuatkan modul yang dinamakan sebelum memuatkan kod apl. Anda boleh memuatkan berbilang modul
dengan menggunakan pilihan ini beberapa kali.

Dalam kombinasi dengan "-r" atau "-R" mungkin tidak mempunyai kesan mulakan semula yang diingini apabila
modul yang dimuatkan diubah dalam direktori pembangunan. Untuk mengelakkan masalah ini anda perlukan
untuk memuatkan modul dengan kod aplikasi menggunakan "-e".

-E, --env, pembolehubah persekitaran "PLACK_ENV".
Menentukan pilihan persekitaran. Menetapkan nilai ini dengan "-E" atau "--env" juga menulis
kepada pembolehubah persekitaran "PLACK_ENV". Ini membolehkan aplikasi atau rangka kerja untuk
beritahu tetapan persekitaran yang mana aplikasi sedang dijalankan.

# Kedua-duanya adalah sama
penempatan plackup -E
env PLACK_ENV=peletakan penempatan

Nilai biasa ialah "pembangunan", "pengerahan" dan "ujian". Nilai lalai ialah
"pembangunan", yang menyebabkan "plakkup" memuatkan komponen perisian tengah: AccessLog,
StackTrace, dan Lint melainkan "--no-default-middleware" ditetapkan.

--no-default-middleware
Ini menghalang pemuatan tindanan middleware lalai walaupun semasa persekitaran Plock (cth
"-E" atau "PLACK_ENV") ditetapkan kepada "pembangunan".

-r, --muat semula
Membuat plackup memulakan semula pelayan setiap kali fail dalam direktori pembangunan anda
perubahan. Pilihan ini secara lalai menonton direktori "lib" dan direktori asas
di mana .psgi fail terletak. Gunakan "-R" untuk menonton direktori lain.

Muat semula akan melambatkan penyusunan permohonan anda. Pengesanan pelayan automatik
(lihat "-s" di atas) mungkin tidak berkelakuan seperti yang anda jangkakan, jika plackup perlu mengimbas anda
aplikasi untuk modul yang digunakannya. Elakkan masalah dengan menyatakan "-s" secara jelas apabila
menggunakan "-r" atau "-R".

Untuk mengelakkan masalah dengan perubahan pada modul pramuat lihat dokumentasi untuk "-M".

-R, --Muat semula
Membuat plackup memulakan semula pelayan setiap kali fail dalam mana-mana direktori yang diberikan
perubahan. "-R" dan "--Muat Semula" mengambil senarai laluan yang dipisahkan koma:

plackup -R /path/to/project/lib,/path/to/project/templates

Untuk mengelakkan masalah dengan perubahan pada modul pramuat lihat dokumentasi untuk "-M".

-L, --pemuat
Menentukan subkelas pemuatan pelayan yang melaksanakan cara menjalankan pelayan.
Pilihan yang ada ialah Plack::Pemuat (lalai), Pemula semula (ditetapkan secara automatik apabila "-r"
atau "-R" digunakan), Ditangguhkan, dan Senapang patah.

Lihat Plack::Loader::Delayed dan Plack::Loader::Shotgun untuk butiran lanjut.

--access-log
Menentukan nama laluan fail yang log akses harus ditulis. Secara lalai,
dalam persekitaran pembangunan log akses akan pergi ke STDERR.

--laluan
Tentukan laluan akar apl anda ("SCRIPT_NAME" dalam PSGI env) untuk dijalankan. Yang berikut
dua arahan adalah lebih kurang sama.

plackup --path /foo app.psgi
plackup -e 'mount "/foo" => Plack::Util::load_psgi("app.psgi")'

Pilihan lain yang bermula dengan "--" dihantar ke pelayan bahagian belakang. Lihat setiap satu
Plak:: Dokumentasi backend Handler untuk butiran lanjut tentang pilihan tersedia mereka.

Gunakan plackupp dalam talian menggunakan perkhidmatan onworks.net