guinso/hx-http

HTTP input and output handler

Maintainers

Details

github.com/guinso/hx-http

Source

Issues

Installs: 47

Dependents: 1

Suggesters: 0

Security: 0

Stars: 1

Watchers: 2

Forks: 0

Open Issues: 0

2.0 2016-07-02 05:35 UTC

Requires

  • php: >=5.6

MIT 1cdc5c1884a4d7680826622254cc41d18bba43ef

http

This package is not auto-updated.

Last update: 2025-01-04 20:25:45 UTC

README

PHP Http input and output handler

Install

  • Composer
    //for PHP 5.5
    {
        "require": {
            "guinso/hx-http": "1.0.*"
        }
    }
    
    //for PHP 7
    {
        "require": {
            "guinso/hx-http": "2.0.*"
        }
    }
  • Manual
    require_once('path-of-hx-http-library/src/autoloader.php');

Example

  • Read Http Input
$httpHeader = new \Hx\Http\HeaderReader();
$httpInputService = new \Hx\Http\InputService();
$arrInfo = $httpInputService.getInput($httpHeader);

//to read general input (no matter GET, POST, or PUT)
$yourClientDataValue = $arrInfo['data']['your-client-specified-data-key'];

//to read client uploaded file path (work for multipart format as well)
$clientUploadTemporaryFilePath = $arrInfo['file']['your-client-specified-file-name'];
  • Write Http Output
    • JSON or XML
    $outputService = new \Hx\Http\OutputService();
$outputData = array(
  'key-A' => 123,
  'key-B' => 'Cat meow',
  'key-C' => [
    'sub-key-1' => 157.67,
    'sub-key-2' => "tree"
  ]
);

//generate JSON output to http
$outputService->generateOutput('json', $outputData);
//OR generate in XML format
$outputService->generateOutput('xml', $outputData);
    • Html
    $outputService = new \Hx\Http\OutputService();
$htmlOutput = array(
  'header' =>  //this is html header tag
    "<title>Page Title</title>
    <link rel="stylesheet" href="mystyle.css">",
  'body' => //this is html body tag
   "<body>
    ...
   </body>"
);

//generate Html output format
$outputService->generateOutput('html', $htmlOutput);
    • Download file to client
    $outputService = new \Hx\Http\OutputService();

$fileInfo = array(
  'fileName' => 'filename-which-you-want-show-to-client',
  'filePath' => 'actual-physical-file-path'
);

//download file to client (client never know physical file location)
$outputService->generateOutput('file', $fileInfo);
    • Plain text format
    $outputService = new \Hx\Http\OutputService();

$data = array("data" => "anything....");

//generate plain text to client
//NOTE: output is not in Html format since it is marked as 'text/plain' MIME type
$outputService->generateOutput('text', $data);