NGINX Unit 1.10.0 Is Now Available<\/p>\n
Summer’s gone, so it’s time to forfeit the halcyon tranquility and get some working attitude on. The NGINX Unit team has recently presented our first two‑digit version, NGINX Unit 1.10.0<\/span><\/a>; let’s page through the recent developments and shed some light on our plans for the future.<\/p>\n In our two latest releases, some major effort went into extending the request routing capabilities that were initially introduced in NGINX Unit 1.8.0<\/span><\/a>. Version 1.9.0 included essential support for arguments, headers, and cookies in matching clauses, whereas NGINX Unit 1.10.0<\/span> added scheme‑based routing<\/a> to the mix. A few examples:<\/p>\n This condition matches queries like www.example.com\/?mode=mobile<\/strong> and www.example.com\/?mode=desktop&ui=compact<\/strong>, but not www.example\/com\/?mode=desktop&ui=full<\/strong>.<\/p>\n This clause matches only requests where the This condition matches https:\/\/example.com<\/strong>, but not http:\/\/example.com<\/strong>.<\/p>\n Pattern matching was also extended to allow wildcards in the middle of the match string: <\/p>\n This clause happily matches all eu-<\/strong> subdomains of example.com<\/strong> except eu-5.example.com<\/span>.<\/p>\n The config API<\/a> received some polishing as well. Most importantly, it now supports non‑idempotent Let’s decipher the JSON: the configuration includes an application called Note that all responses from NGINX Unit are also encoded in JSON. Next, I make a As you can see, the In other news, we’ve also done away with a few nasty bugs, making config manipulation more reliable.<\/p>\n Most of the latest changes in language support are for Node.js, including a new built‑in WebSocket server implementation in NGINX Unit 1.10.0<\/span>. To use it, just specify our module as the parameter to the In addition, NGINX Unit 1.10.0<\/span> adds some axle grease to improve integration with the latest Node.js versions; a few compatibility bugs were fixed as well.<\/p>\n Another significant update to language support is the PHP module’s new ability to parse request URIs into the Our documentation<\/a> has been extended significantly in the last few months with various guides and how‑tos in response to your insightful queries, friendly GitHub rants, and reasonable – but misplaced – assumptions about how some features work.<\/p>\n Some of the major updates include a guide<\/a> to running NGINX Unit in Docker that is accompanied by a sample Dockerfile for each of the supported languages, an end-to-end<\/span> guide<\/a> on language module manipulation, and how‑tos for popular apps and frameworks like Catalyst<\/a> and Redmine<\/a> (along with the aforementioned NextCloud<\/a>). There’s more to come – please check the docs once in a while or post your “gotta see this app run on NGINX Unit” ideas on GitHub.<\/p>\n The journey continues, and NGINX Unit is gaining momentum. Our team is steadily growing with new people bringing new ideas, so follow us for more exciting news (which we already have in the works): see the recent updates in the changelog<\/a> or monitor our GitHub repository<\/a> to join the discussions and development.<\/p>\n Finally, a few words about future updates. At this moment, we are working hard to bring to life such long‑promised features as WebSocket support for Java, serving static assets, and proxying. Our team is quite serious about making NGINX Unit a really busy little web engine. Stay tuned!<\/p>\n Interested in becoming a full\u2011time engineer for NGINX? Check our job board<\/a>.<\/p>\n NGINX Plus subscribers get support for NGINX Unit at no additional charge. Start a free 30‑day trial<\/a> of NGINX Plus today.<\/p>\n The post NGINX Unit 1.10.0 Is Now Available<\/a> appeared first on NGINX<\/a>.<\/p>\n Source: NGINX Unit 1.10.0 Is Now Available<\/a><\/p>\n","protected":false},"excerpt":{"rendered":" NGINX Unit 1.10.0 Is Now Available Summer’s gone, so it’s time to forfeit the halcyon tranquility and get some working attitude on. The NGINX Unit team has recently presented our first two‑digit version, NGINX Unit 1.10.0; let’s page through the recent developments and shed some light on our plans for the future. Routing Advancements In our two latest releases, some major effort went into extending the request routing capabilities that were initially introduced in NGINX Unit 1.8.0. Version 1.9.0 included essential support for arguments, headers, and cookies in matching clauses, whereas NGINX Unit 1.10.0 added scheme‑based routing to the mix. A few examples: “match”: { “host”: “www.example.com”, “arguments”: { “mode”: [“mobile”, “desktop”], “ui”: “!full” } } This condition matches queries like www.example.com\/?mode=mobile and www.example.com\/?mode=desktop&ui=compact, but not www.example\/com\/?mode=desktop&ui=full. “match”: { “headers”: [ { “Accept-Encoding”: “*gzip*”, “User-Agent”: “Mozilla\/5.0*” }, { “User-Agent”: “curl*” } ] [ more… ]<\/a><\/p>\n<\/div>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[169],"tags":[652],"class_list":["post-32926","post","type-post","status-publish","format-standard","hentry","category-news","tag-nginx"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/posts\/32926","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/comments?post=32926"}],"version-history":[{"count":1,"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/posts\/32926\/revisions"}],"predecessor-version":[{"id":32927,"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/posts\/32926\/revisions\/32927"}],"wp:attachment":[{"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/media?parent=32926"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/categories?post=32926"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/tags?post=32926"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Routing Advancements<\/h2>\n
\"match\": {\r\n \"host\": \"www.example.com\",\r\n \"arguments\": {\r\n \"mode\": [\"mobile\", \"desktop\"],\r\n \"ui\": \"!full\"\r\n }\r\n}<\/code><\/pre>\n\"match\": {\r\n \"headers\": [\r\n {\r\n \"Accept-Encoding\": \"*gzip*\",\r\n \"User-Agent\": \"Mozilla\/5.0*\"\r\n },\r\n\r\n {\r\n \"User-Agent\": \"curl*\"\r\n }\r\n ]\r\n}<\/code><\/pre>\nUser-Agent<\/code><\/span> header is either Mozilla\/5.0<\/code> (and gzip<\/code> compression is also applied) or curl<\/code>.<\/p>\n\"match\": {\r\n \"host\": \"example.com\",\r\n \"scheme\": \"https\"\r\n}<\/code><\/pre>\n\"match\": {\r\n \"host\": [\"eu-*.example.com\", \"!eu-5.example.com\"]\r\n}<\/code><\/pre>\nConfiguration Updates<\/h2>\n
POST<\/code> semantics. In less fancy terms, this means you can append new items to arrays, which do occur in NGINX Unit configuration. For instance, consider this sample output from a curl<\/code> query to NGINX Unit’s control socket:<\/p>\n# curl --unix-socket \/path\/to\/control.unit.sock http:\/\/localhost\/config\/<\/span>\r\n\r\n{\r\n \"listeners\": {\r\n \"*:8000\": {\r\n \"pass\": \"routes\"\r\n }\r\n },\r\n\r\n \"applications\": {\r\n \"blogs\": {\r\n \"type\": \"python\",\r\n \"module\": \"wsgi\",\r\n \"path\": \"\/www\/blogs\/\"\r\n }\r\n },\r\n\r\n \"routes\": [\t\r\n {\r\n \"match\": {\r\n \"host\": [\r\n \"dev1.example.com\",\r\n \"dev2.example.com\"\r\n ]\r\n },\r\n\r\n \"action\": {\r\n \"pass\": \"applications\/blogs\"\r\n }\r\n }\r\n ]\r\n}<\/code><\/pre>\nblogs<\/code>, a routes<\/code> section that allows access to the app via two hostnames, and a listener that passes incoming requests through the routing engine. Using the POST<\/code> method, we append a new hostname to the host<\/code> array:<\/p>\n# curl -X POST -d '\"dev3.example.com\"' --unix-socket=\/path\/to\/control.unit.sock \r\n http:\/\/localhost\/config\/routes\/0\/match\/host\/<\/span>\r\n{\r\n \"success\": \"Reconfiguration done.\"\r\n}<\/code><\/pre>\ncurl<\/code> query to display just the routes<\/code> section:<\/p>\n# curl --unix-socket \/path\/to\/control.unit.sock http:\/\/localhost\/config\/routes\/<\/span>\r\n\r\n[\t\r\n {\r\n \"match\": {\r\n \"host\": [\r\n \"dev1.example.com\",\r\n \"dev2.example.com\",\r\n \"dev3.example.com\"\r\n ]\r\n },\r\n\r\n \"action\": {\r\n \"pass\": \"applications\/blogs\"\r\n }\r\n }\r\n]<\/code><\/pre>\nPOST<\/code> operation appended its payload to the end of the host<\/code> array. It’s worth mentioning here that NGINX Unit changes only the sections of the configuration that are affected by the update, calculating the difference between the old config and the new on the fly to minimize overhead. Handy!<\/p>\nApplication Languages<\/h2>\n
require<\/code> function instead of the native websocket<\/code> module:<\/p>\nvar webSocketServer = require('unit-http\/websocket').server;<\/code><\/pre>\nPATH_INFO<\/code> environment variable – something many PHP developers have come to rely on<\/a>. The change might appear tiny, but it makes it easier to run some major apps like NextCloud, as detailed in the shiny new how‑to<\/a> we’ve provided for your convenience. Oh, and speaking of…<\/p>\nDocumentation<\/h2>\n
Conclusion<\/h2>\n