Added a troubleshooting script.

Author: Keith Palmer Jr

docs/partner_platform/example_app_ipp_v3/index.php

@@ -9,9 +9,9 @@
 $dh = opendir(dirname(__FILE__));
 while (false !== ($file = readdir($dh)))
 {
-	if (substr($file, 0, 7) != 'example') 
-	{ 
-		continue; 
+	if (substr($file, 0, 7) != 'example')
+	{
+		continue;
 	}
 
 	$tmp = explode('_', $file);
@@ -23,7 +23,7 @@
 		case 'add.php':
 			$examples[$file] = 'Add a ' . implode(' ', array_slice($tmp, 1, -1));
 			break;
-		case 'void.php';	
+		case 'void.php';
 			$examples[$file] = 'Void a ' . implode(' ', array_slice($tmp, 1, -1));
 			break;
 		case 'update.php':
@@ -58,24 +58,33 @@
 	</h1>
 
 	<p>
-		This app demos a PHP connection to QuickBooks Online via the v3 REST APIs. 
+		This app demos a PHP connection to QuickBooks Online via the v3 REST APIs.
 	</p>
 	<p>
 		<strong>Please make sure you review the <a target="_blank" href="http://www.consolibyte.com/docs/index.php/PHP_DevKit_for_QuickBooks_-_Intuit_Partner_Platform_Quick-Start">quick-start tutorial</a>!</strong>
 	</p>
-	<p>
-		<strong>If you need help, make sure you post your code AND the request/response!</strong> <a href="debugging.php">Don't know how to get the request/response?</a>
-	</p>
+	<h2>
+		Need Help?
+	</h2>
 	<p>
 		You can get support on the forums:
 	</p>
 	<ul>
 		<li><a target="_blank" href="http://www.consolibyte.com/forum/">ConsoliBYTE forums</a></li>
 		<li><a target="_blank" href="https://intuitpartnerplatform.lc.intuit.com/">Intuit Developer forums</a></li>
 	</ul>
+	<p>
+		When you post, <strong>make sure that you:</strong>
+	</p>
+	<ul>
+		<li>Post your code.</li>
+		<li>Check that all of your OAuth credentials and URLs match between your code and your Intuit account.</li>
+		<li>Post your XML request/response. <a href="debugging.php">Don't know how to get the request/response?</a></li>
+		<li>Post the results of the <a href="troubleshooting.php">troubleshooting script</a>.</li>
+	</ul>
 
 	<p>
-		QuickBooks connection status: 
+		QuickBooks connection status:
 
 		<?php if ($quickbooks_is_connected): ?>
 			<div style="border: 2px solid green; text-align: center; padding: 8px; color: green;">
@@ -108,7 +117,7 @@
 				</tr>
 				<tr>
 					<td>
-						<a href="disconnect.php">Disconnect from QuickBooks</a> 
+						<a href="disconnect.php">Disconnect from QuickBooks</a>
 					</td>
 					<td>
 						(If you do this, you'll have to go back through the authorization/connection process to get connected again)
@@ -162,13 +171,13 @@
 				You must authenticate to QuickBooks <b>once</b> before you can exchange data with it. <br>
 				<br>
 				<strong>You only have to do this once!</strong> <br><br>
-				
-				After you've authenticated once, you never have to go 
+
+				After you've authenticated once, you never have to go
 				through this connection process again. <br>
-				Click the button above to 
+				Click the button above to
 				authenticate and connect.
-			</div>	
-		<?php endif; ?>		
+			</div>
+		<?php endif; ?>
 
 	</p>
 </div>

docs/partner_platform/example_app_ipp_v3/troubleshooting.php

@@ -0,0 +1,57 @@
+<?php
+
+ini_set('display_errors', true);
+error_reporting(E_ALL);
+
+header('Content-Type: text/plain');
+
+require_once dirname(__FILE__) . '/../../../QuickBooks.php';
+
+$urls = array(
+	QuickBooks_IPP_IntuitAnywhere::URL_REQUEST_TOKEN,
+	QuickBooks_IPP_IntuitAnywhere::URL_CONNECT_RECONNECT,
+	);
+
+for ($i = 0; $i <= 1; $i++)
+{
+	foreach ($urls as $url)
+	{
+		ob_start();
+		$out = fopen('php://output', 'w');
+
+		$params = array(
+			CURLOPT_RETURNTRANSFER => true,
+			);
+
+		$ch = curl_init($url);
+		curl_setopt_array($ch, $params);
+
+		curl_setopt($ch, CURLOPT_VERBOSE, true);
+		curl_setopt($ch, CURLOPT_STDERR, $out);
+
+		if ($i == 1)
+		{
+			curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
+			curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
+		}
+
+		$response = curl_exec($ch);
+
+		fclose($out);
+		$debug = ob_get_clean();
+
+		print('Trying to hit URL: ' . $url . "\n\n");
+		print('   Did we disable SSL checks? ' . trim(var_export((bool) $i, true)) . "\n");
+		print($debug);
+		print("\n\n");
+		print($response);
+
+		print("\n\n\n\n\n\n\n");
+	}
+}
+
+print('php version: ' . phpversion() . "\n");
+print('mcrypt extension? ' . var_export(function_exists('mcrypt_module_open'), true) . "\n");
+print('  mcrypt module rijndael-256? ' . var_export(mcrypt_module_open('rijndael-256', '', 'ofb', ''), true) . "\n");
+print('curl extension? ' . var_export(function_exists('curl_init'), true) . "\n");
+