ó Xé?_c@s¿dZddlZddlZddlZdefd„ƒYZdefd„ƒYZdefd„ƒYZd efd „ƒYZd „Z d d „Z dZ d Z dd„Zdd„ZdS(s) Starting in CherryPy 3.1, cherrypy.server is implemented as an :ref:`Engine Plugin`. It's an instance of :class:`cherrypy._cpserver.Server`, which is a subclass of :class:`cherrypy.process.servers.ServerAdapter`. The ``ServerAdapter`` class is designed to control other servers, as well. Multiple servers/ports ====================== If you need to start more than one HTTP server (to serve on multiple ports, or protocols, etc.), you can manually register each one and then start them all with engine.start:: s1 = ServerAdapter(cherrypy.engine, MyWSGIServer(host='0.0.0.0', port=80)) s2 = ServerAdapter(cherrypy.engine, another.HTTPServer(host='127.0.0.1', SSL=True)) s1.subscribe() s2.subscribe() cherrypy.engine.start() .. index:: SCGI FastCGI/SCGI ============ There are also Flup\ **F**\ CGIServer and Flup\ **S**\ CGIServer classes in :mod:`cherrypy.process.servers`. To start an fcgi server, for example, wrap an instance of it in a ServerAdapter:: addr = ('0.0.0.0', 4000) f = servers.FlupFCGIServer(application=cherrypy.tree, bindAddress=addr) s = servers.ServerAdapter(cherrypy.engine, httpserver=f, bind_addr=addr) s.subscribe() The :doc:`cherryd` startup script will do the above for you via its `-f` flag. Note that you need to download and install `flup `_ yourself, whether you use ``cherryd`` or not. .. _fastcgi: .. index:: FastCGI FastCGI ------- A very simple setup lets your cherry run with FastCGI. You just need the flup library, plus a running Apache server (with ``mod_fastcgi``) or lighttpd server. CherryPy code ^^^^^^^^^^^^^ hello.py:: #!/usr/bin/python import cherrypy class HelloWorld: """Sample request handler class.""" def index(self): return "Hello world!" index.exposed = True cherrypy.tree.mount(HelloWorld()) # CherryPy autoreload must be disabled for the flup server to work cherrypy.config.update({'engine.autoreload.on':False}) Then run :doc:`/deployguide/cherryd` with the '-f' arg:: cherryd -c -d -f -i hello.py Apache ^^^^^^ At the top level in httpd.conf:: FastCgiIpcDir /tmp FastCgiServer /path/to/cherry.fcgi -idle-timeout 120 -processes 4 And inside the relevant VirtualHost section:: # FastCGI config AddHandler fastcgi-script .fcgi ScriptAliasMatch (.*$) /path/to/cherry.fcgi$1 Lighttpd ^^^^^^^^ For `Lighttpd `_ you can follow these instructions. Within ``lighttpd.conf`` make sure ``mod_fastcgi`` is active within ``server.modules``. Then, within your ``$HTTP["host"]`` directive, configure your fastcgi script like the following:: $HTTP["url"] =~ "" { fastcgi.server = ( "/" => ( "script.fcgi" => ( "bin-path" => "/path/to/your/script.fcgi", "socket" => "/tmp/script.sock", "check-local" => "disable", "disable-time" => 1, "min-procs" => 1, "max-procs" => 1, # adjust as needed ), ), ) } # end of $HTTP["url"] =~ "^/" Please see `Lighttpd FastCGI Docs `_ for an explanation of the possible configuration options. iÿÿÿÿNt ServerAdaptercBsweZdZd d d„Zd„Zd„Zd„Zde_d„Z d„Z d„Z d „Z d e _d „Z RS( s´Adapter for an HTTP server. If you need to start more than one HTTP server (to serve on multiple ports, or protocols, etc.), you can manually register each one and then start them all with bus.start:: s1 = ServerAdapter(bus, MyWSGIServer(host='0.0.0.0', port=80)) s2 = ServerAdapter(bus, another.HTTPServer(host='127.0.0.1', SSL=True)) s1.subscribe() s2.subscribe() bus.start() cCs1||_||_||_d|_t|_dS(N(tbust httpservert bind_addrtNonet interrupttFalsetrunning(tselfRRR((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyt__init__ˆs     cCs0|jjd|jƒ|jjd|jƒdS(Ntstarttstop(Rt subscribeR R (R((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR scCs0|jjd|jƒ|jjd|jƒdS(NR R (Rt unsubscribeR R (R((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR “scCs|jdkrd}n.t|jtƒr9|jƒ}n d|j}|jrg|jjd|ƒdSd|_|j sˆt dƒ‚nt|jtƒrªt |jŒnddl }|j d|jƒ}|jd|jƒƒ|jƒ|jƒt|_|jjd |ƒdS( sStart the HTTP server.sunknown interface (dynamic?)ssocket file: %ssAlready serving on %sNs No HTTP server has been created.iÿÿÿÿttargets HTTPServer s Serving on %s(RRt isinstancettuplet _get_baseRRtlogRRt ValueErrortwait_for_free_portt threadingtThreadt_start_http_threadtsetNametgetNameR twaittTrue(Rton_whatRtt((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR —s(         iKcCs|js dS|j\}}t|jddƒsFt|jddƒrld}|dkr|d|7}qn#d}|dkr|d|7}nd ||fS( Nttssl_certificatet ssl_adapterthttpsi»s:%sthttpiPs%s://%s(RRtgetattrR(Rthosttporttscheme((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR¶s   cCsáy|jjƒWnÉtk rT|jjdƒtjƒd|_|jjƒn‰t k r—|jjdƒtjƒd|_|jjƒ‚nFtjƒd|_|jjddt ddƒ|jjƒ‚nXdS( sHTTP servers MUST be running in new threads, so that the main thread persists to receive KeyboardInterrupt's. If an exception is raised in the httpserver's thread then it's trapped here, and the bus (and therefore our httpserver) are shut down. s' hit: shutting down HTTP serveris,SystemExit raised: shutting down HTTP servers#Error in HTTP server: shutting downt tracebacktleveli(N( RR tKeyboardInterruptRRtsystexc_infoRtexitt SystemExitR(R((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyRÆs"     cCssx;t|jdtƒs=|jr-|j‚ntjdƒqWt|jtƒro|j\}}t ||ƒndS(s8Wait until the HTTP server is ready to receive requests.treadygš™™™™™¹?N( R#RRRttimetsleepRRRtwait_for_occupied_port(RR$R%((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyRßs  cCsv|jr[|jjƒt|jtƒr8t|jŒnt|_|jj d|jƒn|jj d|jƒdS(sStop the HTTP server.sHTTP Server %s shut downs HTTP Server %s already shut downN( RRR RRRRRRR(R((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR ës   icCs|jƒ|jƒdS(sRestart the HTTP server.N(R R (R((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pytrestartùs N(t__name__t __module__t__doc__RR R R R tpriorityRRRR R2(((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyRys        t FlupCGIServercBs)eZdZd„Zd„Zd„ZRS(s)Adapter for a flup.server.cgi.WSGIServer.cOs||_||_t|_dS(N(targstkwargsRR.(RR8R9((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR s  cCsBddlm}||j|jŽ|_t|_|jjƒdS(sStart the CGI server.iÿÿÿÿ(t WSGIServerN(tflup.server.cgiR:R8R9t cgiserverRR.trun(RR:((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR s cCs t|_dS(sStop the HTTP server.N(RR.(R((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR s(R3R4R5R R R (((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR7ÿs  tFlupFCGIServercBs)eZdZd„Zd„Zd„ZRS(s*Adapter for a flup.server.fcgi.WSGIServer.cOsd|jddƒdkrEddl}t|dƒsEtdƒ‚qEn||_||_t|_dS(Nt bindAddressiÿÿÿÿtfromfds{Dynamic FCGI server not available on this platform. You must use a static or external one by providing a legal bindAddress.( tgetRtsocketthasattrRR8R9RR.(RR8R9RB((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR s   cCs]ddlm}||j|jŽ|_d„|j_g|j_t|_|jj ƒdS(sStart the FCGI server.iÿÿÿÿ(R:cSsdS(N(R(((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyt6sN( tflup.server.fcgiR:R8R9t fcgiservert_installSignalHandlerst_oldSIGsRR.R=(RR:((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR 's    cCs1t|j_|jjj|jj_t|_dS(sStop the HTTP server.N(RRFt _keepGoingt _threadPoolt _idleCounttmaxSpareR.(R((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR ;s (R3R4R5R R R (((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR>s tFlupSCGIServercBs)eZdZd„Zd„Zd„ZRS(s*Adapter for a flup.server.scgi.WSGIServer.cOs||_||_t|_dS(N(R8R9RR.(RR8R9((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR Is  cCs]ddlm}||j|jŽ|_d„|j_g|j_t|_|jj ƒdS(sStart the SCGI server.iÿÿÿÿ(R:cSsdS(N(R(((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyRD]sN( tflup.server.scgiR:R8R9t scgiserverRGRHRR.R=(RR:((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR Ns    cCs(t|_t|j_d|jj_dS(sStop the HTTP server.iN(RR.RORIRJRL(R((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR bs  (R3R4R5R R R (((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyRMEs  cCs$|dkrdS|dkr dS|S(sDReturn the host on which a client can connect to the given listener.s0.0.0.0s 127.0.0.1s::s::0s ::0.0.0.0s::1(s::s::0s ::0.0.0.0((t server_host((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyt client_hostks   gð?c CsŽ|stdƒ‚nt|ƒ}t|ƒ}ddl}y"|j|||j|jƒ}Wnq|jk rÎd|kr§|j|jdd||ddffg}qÏ|j |jdd||ffg}nXx¸|D]°}|\}}}} } d} yC|j|||ƒ} | j |ƒ| j ||fƒ| j ƒWn'|jk rc| r†| j ƒq†qÖXtdt|ƒt|ƒfƒ‚qÖWdS(s?Raise an error if the given port is not free on the given host.s*Host values of '' or None are not allowed.iÿÿÿÿNt:iRsTPort %s is in use on %s; perhaps the previous httpserver did not shut down properly.(RRQtintRBt getaddrinfot AF_UNSPECt SOCK_STREAMtgaierrortAF_INET6tAF_INETRt settimeouttconnecttcloseterrortIOErrortrepr( R$R%ttimeoutRBtinfotrestaftsocktypetprotot canonnametsats((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyt check_portxs2    -(  gš™™™™™¹?cCs—|stdƒ‚n|dkr*t}nxPtdƒD]B}yt||d|ƒWntk rttj|ƒq7XdSq7Wtd||fƒ‚dS(s;Wait for the specified port to become free (drop requests).s*Host values of '' or None are not allowed.i2R`NsPort %r not free on %r(RRtfree_port_timeouttrangeRiR^R/R0(R$R%R`ttrial((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR¦s   cCsÀ|stdƒ‚n|dkr*t}nxMtdƒD]?}yt||d|ƒWntk rhdSXtj|ƒq7W|t|ƒkr¥td||fƒ‚nd|}t j |ƒdS(s@Wait for the specified port to become active (receive requests).s*Host values of '' or None are not allowed.i2R`NsPort %r not bound on %rs/Unable to verify that the server is bound on %r( RRtoccupied_port_timeoutRkRiR^R/R0RQtwarningstwarn(R$R%R`Rltmsg((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pyR1ºs    (R5R*R/RntobjectRR7R>RMRQRiRjRmRRR1(((s/local/mnt/workspace/CRMBuilds/Saipan.LA.2.0-00145-STD.PROD-1_20200821_083004/b/common/sectools/ext/cherrypy/process/servers.pytrs   †.& *