support sending in-memory string as file content

Author: Josh Pettett

examples/sendText.php

@@ -0,0 +1,18 @@
+<?php
+
+require_once('phaxio_config.php');
+require_once('autoload.php');
+
+$phaxio = new Phaxio($apiKeys[$apiMode], $apiSecrets[$apiMode], $apiHost);
+
+$params = array(
+    'to' => $toNumber,
+    'file' => array(
+        $phaxio->stringUpload('Page 1'),
+        $phaxio->stringUpload('<b>Page 2<b>')
+    )
+);
+
+$result = $phaxio->sendFax($params);
+var_dump($result);
+

lib/Phaxio.php

@@ -63,6 +63,10 @@ public function retrieveDefaultPhaxCode($getMetadata = false)
         return Phaxio\PhaxCode::init($this)->retrieve($getMetadata);
     }
 
+    public function stringUpload($str, $ext = 'txt') {
+        return new Phaxio\StringUpload($str, $ext);
+    }
+
     # API client methods
 
     public function getApiKey()
@@ -186,13 +190,18 @@ private function curlSetoptCustomPostfields($ch, $postfields, $headers = null)
         }
         foreach ($fields as $field) {
             list($key, $value) = $field;
+
             if (is_resource($value)) {
+                $value = $this->stringUpload(stream_get_contents($value), basename(stream_get_meta_data($value)['uri']));
+            }
+
+            if ($value instanceof Phaxio\StringUpload) {
                 $filename = stream_get_meta_data($value)['uri'];
                 $body[] = '--' . $boundary;
-                $body[] = 'Content-Disposition: form-data; name="' . $key . '"; filename="' . basename($filename) . '"';
+                $body[] = 'Content-Disposition: form-data; name="' . $key . '"; filename="string.' . $value->extension . '"';
                 $body[] = 'Content-Type: application/octet-stream';
                 $body[] = '';
-                $body[] = stream_get_contents($value);
+                $body[] = $value->string;
             } else {
                 $body[] = '--' . $boundary;
                 $body[] = 'Content-Disposition: form-data; name="' . $key . '"';

lib/Phaxio/StringUpload.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Phaxio;
+
+class StringUpload
+{
+    public $string;
+    public $extension;
+
+    public function __construct($str, $ext) {
+        $this->string = $str;
+        $this->extension = $ext;
+    }
+}