Nginx and PHP, match made in heaven

Slide 1

Slide 1 text

Helgi Þormar Þorbjörnsson FOSDEM 2013 Nginx ❤ PHP match made in heaven

Slide 2

Slide 2 text

Co-founded Orchestra.io Work at EngineYard PEAR Developer From Iceland @h on Twitter Helgi

Slide 3

Slide 3 text

Nginx Just a web server?

Slide 4

Slide 4 text

✓ Web Server ✓ Proxy ✓ Cache ✓ Mail Proxy ✓ And more! No! It’s so much more!

Slide 5

Slide 5 text

Important for tweaking

Slide 6

Slide 6 text

Always run conﬁgtest before doing anything!

Slide 7

Slide 7 text

Reload (HUP Signal)

Slide 8

Slide 8 text

Reload (HUP Signal) ‣ Reloads conﬁg ‣ Starts up new workers ‣ Old workers stop listening ‣ Finish up any work they have

Slide 9

Slide 9 text

Upgrade (USR2 Signal)

Slide 10

Slide 10 text

Upgrade (USR2 Signal) ‣ Live upgrade of Nginx executable ‣ Starts up a new Master ‣ Run in parallel ‣ Old Workers gracefully shutdown ‣ Old Master can be brought back

Slide 11

Slide 11 text

Location Blocks

Slide 12

Slide 12 text

Foundation of most things we will do

Slide 13

Slide 13 text

Most Common Block location / { try_files $uri $uri/ /index.php$is_args$args; }

Slide 14

Slide 14 text

location /helgi/is/awesome { return 202; }

Slide 15

Slide 15 text

Accepts Regex Done by adding ~ in front of the regular expression

Slide 16

Slide 16 text

Accepts Regex # deny access to all .dot-files location ~ /\. { access_log off; log_not_found off; deny all; }

Slide 17

Slide 17 text

Accepts Regex # deny access to all backups location ~ ~$ { access_log off; log_not_found off; deny all; }

Slide 18

Slide 18 text

PHP + Nginx configs

Slide 19

Slide 19 text

[global] pid = /var/run/php/fpm.pid error_log = /var/log/php-fpm/error.log log_level = error daemonize = yes [www] listen = /var/run/php/www1.sock user = www-data group = www-data pm = static pm.max_children = 10 pm.max_requests = 500 request_slowlog_timeout = 30 slowlog = /var/log/php-fpm/slow.log

Slide 20

Slide 20 text

upstream web_workers { server unix:/var/run/php/www1.sock; } location / { try_files $uri $uri/ /index.php$is_args$args; } location ~ \.php$ { if (!-f $request_filename) { return 404; } fastcgi_pass web_workers; fastcgi_index index.php; fastcgi_intercept_errors off; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param SERVER_NAME $host; }

Slide 21

Slide 21 text

Health Checks

Slide 22

Slide 22 text

Nginx Check location = /health/ping { return 200 “ok”; }

Slide 23

Slide 23 text

Nginx + FPM [healthcheck] listen = /var/run/php/healthcheck.sock user = www-data pm = static pm.max_children = 1 pm.max_requests = 10000 ping.path = /health/ping ping.response = "pong" PHP FPM Conﬁg

Slide 24

Slide 24 text

Nginx + FPM location = /health/ping { fastcgi_pass healthcheck; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; } upstream healthcheck { server unix:/var/run/php/healthcheck.sock; } Nginx Conﬁg

Slide 25

Slide 25 text

Error Pages

Slide 26

Slide 26 text

Basic Custom 404 error_page 404 /errors/404.html; Requires /errors/404.html to be in the document root

Slide 27

Slide 27 text

Basic Custom 404 root /var/www/public; error_page 404 /errors/404.html; location /errors/404.html { internal; root /var/www; }

Slide 28

Slide 28 text

Errors via PHP error_page 404 @four_oh_four; location @four_oh_four { if (!-f "/var/www/errors/404.php") { return 404; } include fastcgi_params; fastcgi_param SCRIPT_FILENAME /var/www/errors/404.php; fastcgi_pass web_workers; }

Slide 29

Slide 29 text

50x and others error_page 500 501 502 503 504 @five_oh_ex; location @five_oh_ex { } Most HTTP codes can be bunched together

Slide 30

Slide 30 text

Facebook

Slide 31

Slide 31 text

Official Solution error_page 405 =200 $uri;

Slide 32

Slide 32 text

My Hack error_page 405 =200 @four_oh_five; location @four_oh_five { if (!-f $request_filename) { return 404; } proxy_method GET; proxy_pass http://localhost:80; }

Slide 33

Slide 33 text

Rewrite Module

Slide 34

Slide 34 text

Regex (PCRE)

Slide 35

Slide 35 text

Responsible for all if statements, ﬁle exists checks, returns and more.

Slide 36

Slide 36 text

Can work with most Nginx variables such as $http_cookie, $user agent, $uri and countless others.

Slide 37

Slide 37 text

last break redirect permanent Finish rewrite and evaluates all rewrites again Finish rewrite does no further rewrite processing Returns a 302 on the rewrite Returns a 301 on the rewrite

Slide 38

Slide 38 text

server { server_name www.helgi.ws; rewrite ^/(.*)$ helgi.ws/$1 permanent; } server { server_name www.helgi.ws; rewrite ^ helgi.ws$request_uri permanent; } Forward Domains How to send www.helgi.ws to helgi.ws

Slide 39

Slide 39 text

Forward Domains server { server_name www.helgi.ws; return 301 $scheme://helgi.ws$request_uri; } The Correct Way™

Slide 40

Slide 40 text

Headers

Slide 41

Slide 41 text

add_header add_header Set-Cookie "_orchestra=1; Max-Age=2; Path=/";

Slide 42

Slide 42 text

expires location ~* ^.+\.(jpg|js|jpeg|png)$ { expires 1h; }

Slide 43

Slide 43 text

wiki.nginx.org/NginxHttpHeadersMoreModule Introducing

Slide 44

Slide 44 text

more_set_headers 'Server: My-Temple'; # set and clear output headers location /bar { more_set_headers 'X-MyHeader: blah' 'X-MyHeader2: foo'; more_set_headers -t 'text/plain text/css' 'Content-Type: text/foo'; more_set_headers -s '400 404 500 503' -s 413 'Foo: Bar'; more_clear_headers 'Transfer-Encoding' 'Content-Type'; } # set output headers location /type { more_set_headers 'Content-Type: text/plain'; }

Slide 45

Slide 45 text

# set input headers location /foo { more_set_input_headers 'Host: Brussels'; more_set_input_headers -t 'text/plain' 'X-Fosdem: bah'; } # replace input header X-Fosdem *only* if it already exists more_set_input_headers -r 'X-Fosdem: howdy';

Slide 46

Slide 46 text

Load Balancing

Slide 47

Slide 47 text

upstream web_workers { server www1.example.com; server www2.example.com; server www3.example.com; server www4.example.com; } Simple Round Robin

Slide 48

Slide 48 text

upstream web_workers { ip_hash; server www1.example.com; server www2.example.com; server www3.example.com; server www4.example.com; } Consistent IP Routing

Slide 49

Slide 49 text

upstream web_workers { server www1.example.com; server www2.example.com weight=2 max_fails=2 fail_timeout=15; server www3.example.com weight=4 max_fails=3; server www4.example.com weight=4 max_fails=4 fail_timeout=20; keepalive 8; } Different Weights weight and ip_hash can work together in Nginx 1.3.1+

Slide 50

Slide 50 text

Cache

Slide 51

Slide 51 text

http { proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header Host $http_host; proxy_cache_path /dev/shm/nginx levels=1:2 keys_zone=my-cache:8m max_size=2g inactive=600m; proxy_temp_path /dev/shm/nginx/tmp; proxy_cache_use_stale updating; server { location / { proxy_pass http://example.net; proxy_cache my-cache; proxy_cache_valid 200 302 60m; proxy_cache_valid 404 1m; } } }

Slide 52

Slide 52 text

Questions? @h helgi@engineyard.com Please rate at joind.in/7083