plackupp - En ligne dans le Cloud

PROGRAMME:

Nom

plackup - Exécuter l'application PSGI avec les gestionnaires Plack

SYNOPSIS

# lire votre application à partir du fichier app.psgi
ramassage

# choisissez le fichier .psgi depuis ARGV[0] (ou avec l'option -a)
bonjour bonjour.psgi

# changer l'implémentation du serveur avec --server (ou -s)
plackup --server HTTP::Serveur::Simple --port 9090 --host 127.0.0.1 test.psgi

# utiliser le socket UNIX pour exécuter le démon FCGI
plackup -s FCGI --listen /tmp/fcgi.sock monapp.psgi

# lancer le serveur externe FCGI sur le port 9090
plackup -s FCGI --port 9090

DESCRIPTION

plackup est un utilitaire de ligne de commande pour exécuter des applications PSGI à partir de la ligne de commande.

plackup détermine automatiquement l'environnement dans lequel il est exécuté et exécute votre application
dans cet environnement. FastCGI, CGI, AnyEvent et autres peuvent tous être détectés. Voir
Plack::Loader pour la liste faisant autorité.

"plackup" suppose que vous avez un script "app.psgi" dans votre répertoire actuel. Le dernier
L'instruction de "app.psgi" doit être une référence de code qui est une application PSGI :

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

ARGUMENTS

.psgi
plackup --host 127.0.0.1 --port 9090 /chemin/vers/app.psgi

Le premier argument non optionnel est utilisé comme chemin de fichier ".psgi". Vous pouvez également définir ce
chemin avec "-a" ou "--app". S'il est omis, le chemin de fichier par défaut est "app.psgi" dans le
répertoire actuel.

OPTIONS

-a, --app
Spécifie le chemin complet d'un script ".psgi". Vous pouvez également fournir ce chemin comme
le premier argument de "plackup".

-e Évalue le code perl donné en tant qu'application PSGI, un peu comme l'option "-e" de perl :

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

C'est également pratique lorsque vous souhaitez exécuter une application personnalisée comme Plack::App::*.

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

Vous pouvez également spécifier l'option "-e" avec le chemin de fichier ".psgi" pour envelopper l'application avec
configuration du middleware à partir de la ligne de commande. Vous pouvez également utiliser Plack::Builder DSL
syntaxe à l'intérieur du code "-e". Par exemple:

plackup -e 'enable "Auth::Basic", authentificateur => ...;' monapp.psgi

est équivalent à l'application PSGI :

utilisez Plack::Builder;
utilisez Plack::Util;

constructeur {
activer "Auth::Basic", authentificateur => ...;
Plack::Util::load_psgi("monapp.psgi");
};

Notez que lorsque vous utilisez l'option "-e" pour activer le middleware, plackup n'assume pas le
chemin implicite "app.psgi". Vous devez soit passer le chemin de votre fichier ".psgi" dans le
arguments de ligne de commande ou chargez l'application dans "-e" après le "enable".

plackup # Exécute app.psgi
plackup -e 'enable "Foo"' # Ne fonctionne pas !
plackup -e 'activer "Foo"' app.psgi # Fonctionne
plackup -e 'activer "Foo" ; sous { ... }' # Fonctionne

-o, --hôte
Se lie à une interface TCP. La valeur par défaut est undef, ce qui permet à la plupart des backends de serveur de se lier à
l'interface quelconque (*). Cette option n'est valable que pour les serveurs prenant en charge TCP
prises.

-p, --port
Se lie à un port TCP. La valeur par défaut est 5000. Cette option n'est valide que pour les serveurs qui
prend en charge les sockets TCP.

-s, --server, la variable d'environnement "PLACK_SERVER"
Sélectionne une implémentation de serveur spécifique sur laquelle s'exécuter. Lorsqu'ils sont fournis, le "-s" ou
L'indicateur "--server" sera préféré à la variable d'environnement.

Si aucune option n'est donnée, plackup essaiera de détecter le les meilleurs implémentation de serveur basée
sur les variables d'environnement ainsi que les modules chargés par votre application dans %INC.
Voir Plack::Loader pour plus de détails.

-S, --socket
Écoute sur un chemin de socket de domaine UNIX. La valeur par défaut est undef. Cette option n'est valable que pour
serveurs prenant en charge les sockets UNIX.

-l, --écouter
Ecoute sur une ou plusieurs adresses, que ce soit "HOST:PORT", ":PORT" ou "PATH" (sans
deux-points). Vous pouvez utiliser cette option plusieurs fois pour écouter sur plusieurs adresses, mais
le serveur décidera s'il prend en charge plusieurs interfaces.

-D, --démoniser
Exécute le processus en arrière-plan. C'est au serveur/gestionnaire principal
mise en œuvre que cette option soit respectée ou non.

-I Spécifie les chemins d'inclusion de la bibliothèque Perl, comme l'option -I de "perl". Vous pouvez ajouter plusieurs
chemins en utilisant cette option plusieurs fois.

-M Charge les modules nommés avant de charger le code de l'application. Vous pouvez charger plusieurs modules
en utilisant cette option plusieurs fois.

En combinaison avec "-r" ou "-R" peut ne pas avoir l'effet de redémarrage souhaité lorsque le
le module chargé est modifié dans le répertoire de développement. Pour éviter ce problème, vous avez besoin
pour charger le module avec le code de l'application en utilisant "-e".

-E, --env, la variable d'environnement "PLACK_ENV".
Spécifie l'option d'environnement. La définition de cette valeur avec "-E" ou "--env" écrit également
à la variable d'environnement "PLACK_ENV". Cela permet aux applications ou aux frameworks de
indiquer sur quel paramètre d'environnement l'application s'exécute.

# Ces deux sont les mêmes
plackup -E déploiement
env PLACK_ENV=Prise en charge du déploiement

Les valeurs communes sont « développement », « déploiement » et « test ». La valeur par défaut est
« développement », ce qui provoque le chargement des composants middleware par « plackup » : Journal d'accès,
Trace de la pileet la bien-aimée Sonate en la majeur Ruban à moins que "--no-default-middleware" ne soit défini.

--pas de middleware par défaut
Cela empêche le chargement de la pile middleware par défaut même lorsque l'environnement Plack (c'est-à-dire
"-E" ou "PLACK_ENV") est défini sur "développement".

-r, --recharger
Fait redémarrer le serveur chaque fois qu'un fichier se trouve dans votre répertoire de développement
changements. Cette option surveille par défaut le répertoire "lib" et le répertoire de base
où .psgi le fichier se trouve. Utilisez "-R" pour regarder d'autres répertoires.

Le rechargement retardera la compilation de votre application. Détection automatique du serveur
(voir "-s" ci-dessus) peut ne pas se comporter comme prévu, si plackup doit analyser votre
application pour les modules qu'il utilise. Évitez les problèmes en spécifiant "-s" explicitement lorsque
en utilisant "-r" ou "-R".

Pour éviter les problèmes avec les modifications apportées aux modules préchargés, consultez la documentation pour "-M".

-R, --Recharger
Fait redémarrer le serveur chaque fois qu'un fichier se trouve dans l'un des répertoires donnés
changements. "-R" et "--Reload" prennent une liste de chemins séparés par des virgules :

plackup -R /chemin/vers/projet/lib,/chemin/vers/projet/modèles

Pour éviter les problèmes avec les modifications apportées aux modules préchargés, consultez la documentation pour "-M".

-L, --chargeur
Spécifie la sous-classe de chargement du serveur qui implémente la façon d'exécuter le serveur.
Les options disponibles sont Plack::Chargeur (Par défaut), Restarter (défini automatiquement lorsque "-r"
ou "-R" est utilisé), différéet la bien-aimée Sonate en la majeur Fusil à pompe.

Voir Plack::Loader::Delayed et Plack::Loader::Shotgun pour plus de détails.

--access-log
Spécifie le chemin d'accès d'un fichier dans lequel le journal d'accès doit être écrit. Par défaut,
dans les journaux d'accès de l'environnement de développement iront à STDERR.

--chemin
Spécifiez le chemin racine de votre application ("SCRIPT_NAME" dans l'environnement PSGI) à exécuter. Ce qui suit
deux commandes sont à peu près les mêmes.

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

Les autres options commençant par "--" sont transmises au serveur principal. Voir chaque
La documentation du backend Plack::Handler pour plus de détails sur leurs options disponibles.

Utilisez plackupp en ligne en utilisant les services onworks.net