plackupp - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

plackup - ແລ່ນແອັບພລິເຄຊັນ PSGI ກັບຕົວຈັດການ Plack

ສະຫຼຸບສັງລວມ

# ອ່ານແອັບຂອງເຈົ້າຈາກໄຟລ໌ app.psgi
ຟອກ

# ເລືອກໄຟລ໌ .psgi ຈາກ ARGV[0] (ຫຼືມີທາງເລືອກ -a)
plackup hello.psgi

# ສະຫຼັບການປະຕິບັດເຊີບເວີດ້ວຍ --server (ຫຼື -s)
plackup --server HTTP::Server::Simple --port 9090 --host 127.0.0.1 test.psgi

# ໃຊ້ຊັອກເກັດ UNIX ເພື່ອແລ່ນ daemon FCGI
plackup -s FCGI --ຟັງ /tmp/fcgi.sock myapp.psgi

# ເປີດເຊີບເວີພາຍນອກ FCGI ໃນພອດ 9090
plackup -s FCGI --ພອດ 9090

ລາຍລະອຽດ

plackup ເປັນ​ປະ​ໂຫຍດ​ບັນ​ຊີ​ຄໍາ​ສັ່ງ​ເພື່ອ​ດໍາ​ເນີນ​ການ​ຄໍາ​ຮ້ອງ​ສະ​ຫມັກ PSGI ຈາກ​ບັນ​ຊີ​ຄໍາ​ສັ່ງ​.

plackup ອັດຕະໂນມັດຄິດໄລ່ສະພາບແວດລ້ອມທີ່ມັນຖືກແລ່ນຢູ່ໃນ, ແລະດໍາເນີນການຄໍາຮ້ອງສະຫມັກຂອງທ່ານ
ໃນສະພາບແວດລ້ອມນັ້ນ. FastCGI, CGI, AnyEvent ແລະອື່ນໆສາມາດກວດພົບໄດ້. ເບິ່ງ
Plack::Loader ສໍາລັບບັນຊີລາຍຊື່ authoritative.

"plackup" ສົມມຸດວ່າທ່ານມີສະຄິບ "app.psgi" ໃນໄດເລກະທໍລີປະຈຸບັນຂອງທ່ານ. ສຸດ​ທ້າຍ
ຖະແຫຼງການຂອງ "app.psgi" ຄວນຈະເປັນການອ້າງອີງລະຫັດທີ່ເປັນແອັບພລິເຄຊັນ PSGI:

#!/usr/bin/perl
ໃຊ້ MyApp;
my $application = MyApp->ໃໝ່;
$app = sub { $application->run_psgi(@_) };

ການໂຕ້ຖຽງ

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

ການໂຕ້ຖຽງທີ່ບໍ່ແມ່ນທາງເລືອກທໍາອິດແມ່ນໃຊ້ເປັນເສັ້ນທາງໄຟລ໌ ".psgi". ນອກນັ້ນທ່ານຍັງສາມາດກໍານົດນີ້
ເສັ້ນທາງທີ່ມີ "-a" ຫຼື "--app". ຖ້າຖືກລະເວັ້ນ, ເສັ້ນທາງໄຟລ໌ເລີ່ມຕົ້ນແມ່ນ "app.psgi" ໃນ
ໄດເລກະທໍລີປະຈຸບັນ.

OPTIONS

-a, --app
ລະບຸເສັ້ນທາງເຕັມໄປຫາສະຄຣິບ ".psgi". ທ່ານອາດຈະສະລັບກັນໃຫ້ເສັ້ນທາງນີ້ເປັນ
ການໂຕ້ຖຽງຄັ້ງທໍາອິດກັບ "packup".

-e ປະເມີນລະຫັດ perl ທີ່ເປັນແອັບຯ PSGI, ຄືກັນກັບທາງເລືອກ "-e" ຂອງ perl:

plackup -e 'sub { ຂອງຂ້ອຍ $env = shift; ກັບຄືນ [ ... ] }'

ມັນຍັງເປັນປະໂຫຍດໃນເວລາທີ່ທ່ານຕ້ອງການດໍາເນີນການຄໍາຮ້ອງສະຫມັກທີ່ກໍາຫນົດເອງເຊັ່ນ: Plack::App::*.

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

ນອກນັ້ນທ່ານຍັງສາມາດກໍານົດ "-e" ທາງເລືອກທີ່ມີ ".psgi" ເສັ້ນທາງໄຟລ໌ທີ່ຈະຫໍ່ຄໍາຮ້ອງສະຫມັກທີ່ມີ
ການຕັ້ງຄ່າຕົວກາງຈາກແຖວຄໍາສັ່ງ. ທ່ານຍັງສາມາດໃຊ້ Plack::Builder DSL
syntax ພາຍໃນລະຫັດ "-e". ຍົກ​ຕົວ​ຢ່າງ:

plackup -e 'ເປີດໃຊ້ "Auth::Basic", authenticator => ...;' myapp.psgi

ເທົ່າກັບຄໍາຮ້ອງສະຫມັກ PSGI:

ໃຊ້ Plack::Builder;
ໃຊ້ Plack::Util;

ຜູ້ກໍ່ສ້າງ {
ເປີດໃຊ້ "Auth::Basic", authenticator => ... ;
Plack::Util::load_psgi("myapp.psgi");
};

ໃຫ້ສັງເກດວ່າເມື່ອທ່ານໃຊ້ທາງເລືອກ "-e" ເພື່ອເປີດໃຊ້ງານກາງ, plackup ບໍ່ໄດ້ສົມມຸດວ່າ
ເສັ້ນທາງ "app.psgi" implicit. ທ່ານຕ້ອງຜ່ານເສັ້ນທາງໄປຫາໄຟລ໌ ".psgi" ຂອງທ່ານໃນ
ການໂຕ້ຖຽງແຖວຄໍາສັ່ງຫຼືໂຫລດແອັບພລິເຄຊັນພາຍໃນ "-e" ຫຼັງຈາກ "ເປີດໃຊ້".

plackup # ແລ່ນ app.psgi
plackup -e 'ເປີດໃຊ້ "Foo"' # ບໍ່ໄດ້ຜົນ!
plackup -e 'ເປີດໃຊ້ "Foo"' app.psgi # ເຮັດວຽກ
plackup -e 'ເປີດໃຊ້ "Foo"; sub { ... }' # ວຽກ

-o, --host
ຜູກມັດກັບການໂຕ້ຕອບ TCP. ຄ່າເລີ່ມຕົ້ນຂອງ undef, ເຊິ່ງເຮັດໃຫ້ເຄື່ອງແມ່ຂ່າຍ backends ສ່ວນໃຫຍ່ຜູກມັດກັບ
ການໂຕ້ຕອບໃດໆ (*). ຕົວເລືອກນີ້ໃຊ້ໄດ້ກັບເຊີບເວີທີ່ຮອງຮັບ TCP ເທົ່ານັ້ນ
ເຕົ້າຮັບ.

-p, --ພອດ
ຜູກມັດກັບພອດ TCP. ຄ່າເລີ່ມຕົ້ນເປັນ 5000. ຕົວເລືອກນີ້ໃຊ້ໄດ້ສະເພາະກັບເຊີບເວີເທົ່ານັ້ນ
ຮອງຮັບ TCP sockets.

-s, --server, ຕົວແປສະພາບແວດລ້ອມ "PLACK_SERVER".
ເລືອກການປະຕິບັດເຊີບເວີສະເພາະເພື່ອດໍາເນີນການ. ເມື່ອສະຫນອງໃຫ້, "-s" ຫຼື
ທຸງ "--server" ຈະຖືກເລືອກຫຼາຍກວ່າຕົວແປສະພາບແວດລ້ອມ.

ຖ້າ​ຫາກ​ວ່າ​ບໍ່​ມີ​ທາງ​ເລືອກ​ທີ່​ຖືກ​ໃຫ້​, plackup ຈະ​ພະ​ຍາ​ຍາມ​ເພື່ອ​ກວດ​ສອບ​ການ​ ທີ່ດີທີ່ສຸດ ການປະຕິບັດເຄື່ອງແມ່ຂ່າຍໂດຍອີງໃສ່
ກ່ຽວກັບຕົວແປສະພາບແວດລ້ອມເຊັ່ນດຽວກັນກັບໂມດູນທີ່ໂຫລດໂດຍແອັບພລິເຄຊັນຂອງທ່ານໃນ %INC.
ເບິ່ງ Plack::Loader ສໍາລັບລາຍລະອຽດ.

-S, --socket
ຟັງຢູ່ໃນເສັ້ນທາງຊັອກເກັດໂດເມນ UNIX. ຄ່າເລີ່ມຕົ້ນເປັນ undef. ທາງເລືອກນີ້ແມ່ນໃຊ້ໄດ້ພຽງແຕ່ສໍາລັບ
ເຊີບເວີທີ່ຮອງຮັບຊັອກເກັດ UNIX.

-l, --ຟັງ
ຟັງຢູ່ໃນຫນຶ່ງຫຼືຫຼາຍທີ່ຢູ່, ບໍ່ວ່າຈະເປັນ "HOST:PORT", ":PORT", ຫຼື "PATH" (ໂດຍບໍ່ມີການ
ຈໍ້າສອງເມັດ). ເຈົ້າອາດຈະໃຊ້ຕົວເລືອກນີ້ຫຼາຍຄັ້ງເພື່ອຟັງຫຼາຍທີ່ຢູ່, ແຕ່
ເຊີບເວີຈະຕັດສິນໃຈວ່າມັນຮອງຮັບຫຼາຍການໂຕ້ຕອບຫຼືບໍ່.

-D, --daemonize
ເຮັດໃຫ້ຂະບວນການດໍາເນີນຢູ່ໃນພື້ນຫລັງ. ມັນຂຶ້ນກັບເຊີບເວີ/ຕົວຈັດການ
ການປະຕິບັດບໍ່ວ່າຈະເປັນການເຄົາລົບທາງເລືອກນີ້ຫຼືບໍ່.

-I ກໍານົດຫ້ອງສະຫມຸດ Perl ປະກອບມີເສັ້ນທາງເຊັ່ນ "perl" ຂອງ -I ທາງເລືອກ. ເຈົ້າອາດຈະເພີ່ມຫຼາຍອັນ
ເສັ້ນທາງໂດຍການໃຊ້ທາງເລືອກນີ້ຫຼາຍຄັ້ງ.

-M ໂຫຼດໂມດູນທີ່ມີຊື່ກ່ອນທີ່ຈະໂຫລດລະຫັດຂອງແອັບຯ. ທ່ານອາດຈະໂຫລດຫຼາຍໂມດູນ
ໂດຍ​ການ​ນໍາ​ໃຊ້​ທາງ​ເລືອກ​ນີ້​ຫຼາຍ​ຄັ້ງ​.

ໃນການປະສົມປະສານກັບ "-r" ຫຼື "-R" ອາດຈະບໍ່ມີຜົນກະທົບ restart ທີ່ຕ້ອງການໃນເວລາທີ່
ໂມດູນທີ່ໂຫລດຖືກປ່ຽນແປງຢູ່ໃນໄດເລກະທໍລີການພັດທະນາ. ເພື່ອຫຼີກເວັ້ນບັນຫານີ້, ທ່ານຕ້ອງການ
ເພື່ອໂຫລດໂມດູນທີ່ມີລະຫັດ app ໂດຍໃຊ້ "-e".

-E, --env, ຕົວແປສະພາບແວດລ້ອມ "PLACK_ENV".
ລະບຸທາງເລືອກສະພາບແວດລ້ອມ. ການກໍານົດຄ່ານີ້ດ້ວຍ "-E" ຫຼື "--env" ຍັງຂຽນ
ກັບຕົວແປສະພາບແວດລ້ອມ "PLACK_ENV". ນີ້ອະນຸຍາດໃຫ້ຄໍາຮ້ອງສະຫມັກຫຼືກອບເພື່ອ
ບອກສະພາບແວດລ້ອມທີ່ການຕັ້ງຄ່າແອັບພລິເຄຊັນກໍາລັງເຮັດວຽກຢູ່.

#ສອງອັນນີ້ຄືກັນ
ການຈັດວາງ plackup -E
env PLACK_ENV=ການຈັດວາງການຈັດສົ່ງ

ຄຸນຄ່າທົ່ວໄປແມ່ນ "ການພັດທະນາ", "ການນໍາໃຊ້", ແລະ "ການທົດສອບ". ຄ່າເລີ່ມຕົ້ນແມ່ນ
"ການພັດທະນາ", ເຊິ່ງເຮັດໃຫ້ "packup" ໂຫຼດອົງປະກອບກາງ: ບັນທຶກການເຂົ້າເຖິງ,
StackTrace, ແລະ Lint ເວັ້ນເສຍແຕ່ວ່າ "--no-default-middleware" ຖືກຕັ້ງ.

--no-default-middleware
ນີ້ປ້ອງກັນການໂຫຼດ stack ກາງໃນຕອນຕົ້ນເຖິງແມ່ນວ່າໃນເວລາທີ່ສະພາບແວດລ້ອມ Plack (ie
"-E" ຫຼື "PLACK_ENV") ຖືກຕັ້ງເປັນ "ການພັດທະນາ".

-r, --ໂຫຼດໃໝ່
ເຮັດໃຫ້ plackup restart ເຊີບເວີທຸກຄັ້ງທີ່ມີໄຟລ໌ຢູ່ໃນໄດເລກະທໍລີການພັດທະນາຂອງທ່ານ
ການປ່ຽນແປງ. ຕົວເລືອກນີ້ໂດຍຄ່າເລີ່ມຕົ້ນຈະເບິ່ງໄດເລກະທໍລີ "lib" ແລະໄດເລກະທໍລີພື້ນຖານ
ບ່ອນທີ່ .psgi ໄຟລ໌ຕັ້ງຢູ່. ໃຊ້ "-R" ເພື່ອເບິ່ງລາຍການອື່ນໆ.

ການໂຫຼດຄືນໃໝ່ຈະເຮັດໃຫ້ການລວບລວມແອັບພລິເຄຊັນຂອງທ່ານຊັກຊ້າ. ການກວດຫາເຊີບເວີອັດຕະໂນມັດ
(ເບິ່ງ "-s" ຂ້າງເທິງ) ອາດຈະບໍ່ປະຕິບັດຕົວຕາມທີ່ທ່ານຄາດຫວັງ, ຖ້າ plackup ຕ້ອງການສະແກນຂອງທ່ານ
ຄໍາຮ້ອງສະຫມັກສໍາລັບໂມດູນທີ່ມັນໃຊ້. ຫຼີກເວັ້ນບັນຫາໂດຍການລະບຸ "-s" ຢ່າງຊັດເຈນເມື່ອ
ໂດຍໃຊ້ "-r" ຫຼື "-R".

ເພື່ອຫຼີກເວັ້ນການມີບັນຫາກັບການປ່ຽນແປງຂອງໂມດູນ preloaded ເບິ່ງເອກະສານສໍາລັບ "-M".

-R, --ໂຫຼດໃໝ່
ເຮັດໃຫ້ plackup restart ເຊີບເວີທຸກຄັ້ງທີ່ໄຟລ໌ຢູ່ໃນໄດເລກະທໍລີໃດນຶ່ງທີ່ໃຫ້ໄວ້
ການປ່ຽນແປງ. "-R" ແລະ "--Reload" ເອົາລາຍການເສັ້ນທາງທີ່ຂັ້ນດ້ວຍເຄື່ອງໝາຍຈຸດ:

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

ເພື່ອຫຼີກເວັ້ນການມີບັນຫາກັບການປ່ຽນແປງຂອງໂມດູນ preloaded ເບິ່ງເອກະສານສໍາລັບ "-M".

-L, --loader
ລະບຸ subclass ຂອງການໂຫຼດເຊີບເວີທີ່ປະຕິບັດວິທີການດໍາເນີນການເຄື່ອງແມ່ຂ່າຍ.
ທາງ​ເລືອກ​ທີ່​ມີ​ຢູ່​ແມ່ນ​ Plack::Loader (ຄ່າເລີ່ມຕົ້ນ), ຣີສະຕາດ (ຕັ້ງອັດຕະໂນມັດເມື່ອ "-r"
ຫຼື "-R" ຖືກນໍາໃຊ້), ຊັກຊ້າ, ແລະ ປືນ.

ເບິ່ງ Plack::Loader::Delayed and Plack::Loader::Shotgun ສໍາລັບລາຍລະອຽດເພີ່ມເຕີມ.

--access-log
ລະບຸຊື່ເສັ້ນທາງຂອງໄຟລ໌ທີ່ບັນທຶກການເຂົ້າເຖິງຄວນຈະຖືກຂຽນ. ໂດຍຄ່າເລີ່ມຕົ້ນ,
ບັນທຶກການເຂົ້າເຖິງສະພາບແວດລ້ອມການພັດທະນາຈະໄປທີ່ STDERR.

--ເສັ້ນທາງ
ລະບຸເສັ້ນທາງຮາກຂອງແອັບຯຂອງເຈົ້າ ("SCRIPT_NAME" ໃນ PSGI env) ເພື່ອແລ່ນ. ຕໍ່ໄປນີ້
ສອງຄໍາສັ່ງແມ່ນປະມານຄືກັນ.

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

ທາງເລືອກອື່ນທີ່ເລີ່ມຕົ້ນດ້ວຍ "--" ຖືກສົ່ງຜ່ານໄປຍັງເຊີບເວີ backend. ເບິ່ງແຕ່ລະຄົນ
Plack::ເອກະສານຂອງຕົວຈັດການ backend ສໍາລັບລາຍລະອຽດເພີ່ມເຕີມກ່ຽວກັບທາງເລືອກທີ່ມີຂອງພວກເຂົາ.

ໃຊ້ plackupp ອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net