Streaming chunked data

Author: whizsid

.gitignore

@@ -0,0 +1,2 @@
+vendor/
+composer.lock

README.md

@@ -1,21 +1,79 @@
 # FPDF
-**This repository is only made for cloning official FPDF releases which are available at: http://www.fpdf.org**
-**THERE WILL BE NO DEVELOPMENT IN THIS REPOSITORY!**
 
-FPDF is a PHP class which allows to generate PDF files with pure PHP. F from FPDF stands for Free: you may use it for any kind of usage and modify it to suit your needs.
+This is a fork of official mirror of the FPDF library. We changed it to
+support streaming chunked data. You can avoid memory exceed errors by
+using this library.
+
+[Official FPDF Documentation](http://www.fpdf.org/)
 
 ## Installation with [Composer](https://packagist.org/packages/setasign/fpdf)
 
 If you're using Composer to manage dependencies, you can use
 
-    $ composer require setasign/fpdf:^1.8
+```
+$ composer require arimac/fpdf:^1.8
+```
 
 or you can include the following in your composer.json file:
 
 ```json
 {
     "require": {
-        "setasign/fpdf": "^1.8"
+        "arimac/fpdf": "^1.8"
     }
 }
 ```
+
+## Usage
+
+- To download a file as a stream
+
+```
+<?php
+require('fpdf.php');
+
+$pdf = new FPDF();
+$pdf->StartDownload('sales_report.pdf');
+for($i=0; $i<100000; $i++) {
+  $pdf->AddPage();
+  $pdf->SetFont('Arial','B',16);
+  $pdf->Cell(40,10,'Hello World!');
+}
+$pdf->Close();
+```
+
+Now FPDF will sending the generated data to the browser without waiting
+to finish the loop.
+
+- To present a preview of a file as stream
+
+```
+require('fpdf.php');
+
+$pdf = new FPDF();
+$pdf->StartPreview('sales_report.pdf');
+for($i=0; $i<100000; $i++) {
+  $pdf->AddPage();
+  $pdf->SetFont('Arial','B',16);
+  $pdf->Cell(40,10,'Hello World!');
+}
+$pdf->Close();
+```
+
+Same as above method. But it opening the generated PDF file insteed of
+downloading.
+
+- To directly write to a file
+
+```
+require('fpdf.php');
+
+$pdf = new FPDF();
+$pdf->StartFile('sales_report.pdf');
+for($i=0; $i<100000; $i++) {
+  $pdf->AddPage();
+  $pdf->SetFont('Arial','B',16);
+  $pdf->Cell(40,10,'Hello World!');
+}
+$pdf->Close();
+```

composer.json

@@ -1,5 +1,5 @@
 {
-    "name": "setasign/fpdf",
+    "name": "arimac/fpdf",
     "homepage": "http://www.fpdf.org",
     "description": "FPDF is a PHP class which allows to generate PDF files with pure PHP. F from FPDF stands for Free: you may use it for any kind of usage and modify it to suit your needs.",
     "type": "library",
@@ -10,6 +10,11 @@
             "name": "Olivier Plathey",
             "email": "oliver@fpdf.org",
             "homepage": "http://fpdf.org/"
+        },
+        {
+            "name": "Ramesh Kithsiri",
+            "email": "ramesh@arimaclanka.com",
+            "homepage": "https://arimaclanka.com/"
         }
     ],
     "autoload": {