Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/antonheryanto/lua-resty-post
HTTP post utility for openresty
https://github.com/antonheryanto/lua-resty-post
lua luajit nginx openresty
Last synced: 7 days ago
JSON representation
HTTP post utility for openresty
- Host: GitHub
- URL: https://github.com/antonheryanto/lua-resty-post
- Owner: antonheryanto
- Created: 2015-08-03T12:11:04.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-06-24T10:38:19.000Z (over 3 years ago)
- Last Synced: 2024-02-13T00:46:38.056Z (9 months ago)
- Topics: lua, luajit, nginx, openresty
- Language: Lua
- Size: 20.5 KB
- Stars: 34
- Watchers: 3
- Forks: 11
- Open Issues: 2
-
Metadata Files:
- Readme: README.markdown
Awesome Lists containing this project
- awesome-resty - lua-resty-post
README
lua-resty-post
==============
Openresty utility for HTTP post
Table of Contents
=================
* [Status](#status)
* [Description](#description)
* [Installation](#installation)
* [How to use](#how-to-use)
* [Copyright and License](#copyright-and-license)
* [See Also](#see-also)
Status
======
This library beta tested and used in production.
Description
===========
This library processed HTTP using [lua-resty-upload](https://github.com/openresty/lua-resty-upload) which very fast and low memory used, it handles multiple type of HTTP POST and converted into lua table:
* application/x-www-form-urlencoded
* application/json
* multipart/form-data
* [FormData](https://developer.mozilla.org/en-US/docs/Web/API/FormData)
* [File Upload](#file-upload)
* [Array Input](#array-input)
[Back to TOC](#table-of-contents)
Installation
============
* Download or clone this repo
* copy or link to openresty/lualib/resty/ or to any your lua_package_path
[Back to TOC](#table-of-contents)
How to use
==========
```lua
local resty_post = require 'resty.post'
local post = resty_post:new()
local m = post:read()
-- return table with all form value and file
```
[Back to TOC](#table-of-contents)
File Upload
===========
* Support multiple file upload
* Files info are stored in files property using field name as key
```lua
{
files = {
file1 = { -- input name
name = "a.txt",
type = "text/plain",
size = 10240,
tmp_name = 1454551131.5459
},
file2 = {
name = "b.png",
type = "image/png",
size = 20480,
tmp_name = 1454553275.6401
}
}
```
* Define path for files upload or default to logs directory (follow ngx.config.prefix)
* Default file will be saved to tmp name (require moving action to destination)
``` lua
local resty_post = require "resty.post"
local post = resty_post:new({
path = "/my/path", -- path upload file will be saved
chunk_size = 10240, -- default 8192
no_tmp = true, -- if set original name will uses or generate random name
name = function(name, field) -- overide name with user defined function
return name.."_"..field
end
})
post:read()
```
Array Input
===========
Support multiple input of similar name
--------------------------------------
It is useful for thing like HTML input checkboxes or select in multiple mode
```html
Please select
One
Two
```
converted into
``` lua
{
check_multi = { 1, 2 },
select_multi = { 1, 2 }
}
```
When checked one similar with [ngx.req.get_post_args](https://github.com/openresty/lua-nginx-module#ngxreqget_post_args)
``` lua
{
check_multi = 2,
select_multi = 1
}
```
Support array input with name
--------------------------------------
This is like supporting input which mimic class and property, which can be uses to handle dynamic input
support PHP style (dynamic language) and ASP.NET MVC binding style (static language which uses class)
```html
```
converted into
```lua
{
name = {
"Bar",
"Foo"
},
user = {
title = "Mr.",
name = "Foo Bar"
},
users = {
{
title = "Mr.",
name = "John Do"
},
{
title = "Ms.",
name = "Jane Do"
}
}
}
```
[Back to TOC](#table-of-contents)
Copyright and License
=====================
This module is licensed under the BSD license.
Copyright (C) 2015, by Anton Heryanto Hasan.
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
[Back to TOC](#table-of-contents)
See Also
========
* [lua-resty-stack](https://github.com/antonheryanto/lua-resty-stack)
* [lua-resty-upload](https://github.com/openresty/lua-resty-upload)
* [lua-nginx-module](https://github.com/openresty/lua-nginx-module)
[Back to TOC](#table-of-contents)