Method that retrieves an oauth Request Token for 3-legged authentication

.gitignore

@@ -1,2 +1,3 @@
+/.idea
 /vendor
 /composer.lock

examples/custom-request.php

@@ -16,11 +16,11 @@
 <title>Twitter retweets of me</title>
 
 <ul>
-<?php foreach ($statuses as $status): ?>
+<?php foreach ($statuses as $status) { ?>
 	<li><a href="http://twitter.com/<?php echo $status->user->screen_name ?>"><img src="<?php echo htmlspecialchars($status->user->profile_image_url_https) ?>">
 		<?php echo htmlspecialchars($status->user->name) ?></a>:
 		<?php echo Twitter::clickable($status) ?>
 		<small>at <?php echo date('j.n.Y H:i', strtotime($status->created_at)) ?></small>
 	</li>
-<?php endforeach ?>
+<?php } ?>
 </ul>

examples/load.php

@@ -19,11 +19,11 @@
 <title>Twitter timeline demo</title>
 
 <ul>
-<?php foreach ($statuses as $status): ?>
+<?php foreach ($statuses as $status) { ?>
 	<li><a href="https://twitter.com/<?php echo $status->user->screen_name ?>"><img src="<?php echo htmlspecialchars($status->user->profile_image_url_https) ?>">
 		<?php echo htmlspecialchars($status->user->name) ?></a>:
 		<?php echo Twitter::clickable($status) ?>
 		<small>at <?php echo date('j.n.Y H:i', strtotime($status->created_at)) ?></small>
 	</li>
-<?php endforeach ?>
+<?php } ?>
 </ul>

examples/search.php

@@ -16,11 +16,11 @@
 <title>Twitter search demo</title>
 
 <ul>
-<?php foreach ($results as $status): ?>
+<?php foreach ($results as $status) { ?>
 	<li><a href="https://twitter.com/<?php echo $status->user->screen_name ?>"><img src="<?php echo htmlspecialchars($status->user->profile_image_url_https) ?>">
 		<?php echo htmlspecialchars($status->user->name) ?></a>:
 		<?php echo Twitter::clickable($status) ?>
 		<small>at <?php echo date('j.n.Y H:i', strtotime($status->created_at)) ?></small>
 	</li>
-<?php endforeach ?>
+<?php } ?>
 </ul>

readme.md

@@ -113,6 +113,27 @@ if (!$twitter->authenticate()) {
 }
 ```
 
+The `getRequestToken()` method allows a Consumer application to obtain an OAuth Request Token to request user authorization:
+ - Documentation/Use-Cases: https://developer.twitter.com/en/docs/authentication/api-reference/request_token
+ - Define a Callback URL in your Twitter Application (Required): https://developer.twitter.com/en/docs/apps/callback-urls
+```php
+# You can Initialize a new Twitter object using only the Consumer Key and Secret
+$this->twitter = new Twitter($consumerKey, $consumerSecret);
+# Call the getRequestToken() using the callback URL defined in your twitter application.
+$response = $this->twitter->getRequestToken('https://localhost.com/twitter-callback-url');
+```
+
+Example Response:
+
+```php 
+{
+    "oauth_token": "x-oFdAAAAAABVLnXXXXXXXX_XXX",
+    "oauth_token_secret": "A810fifujUZXXXXXXXXXXXXXXXXXXXXX",
+    "oauth_callback_confirmed": "true"
+}
+```
+
+
 Other commands
 --------------
 

src/OAuth.php

@@ -302,12 +302,17 @@ public function __construct(string $http_method, string $http_url, array $parame
 	/**
 	 * attempt to build up a request from what was passed to the server
 	 */
-	public static function from_request(string $http_method = null, string $http_url = null, array $parameters = null): self
-	{
+	public static function from_request(
+		string $http_method = null,
+		string $http_url = null,
+		array $parameters = null
+	): self {
 		$scheme = (!isset($_SERVER['HTTPS']) || $_SERVER['HTTPS'] != 'on')
 			? 'http'
 			: 'https';
-		$http_url = ($http_url) ? $http_url : $scheme .
+		$http_url = ($http_url)
+			? $http_url
+			: $scheme .
 			'://' . $_SERVER['HTTP_HOST'] .
 			':' .
 			$_SERVER['SERVER_PORT'] .
@@ -339,7 +344,10 @@ public static function from_request(string $http_method = null, string $http_url
 
 			// We have a Authorization-header with OAuth data. Parse the header
 			// and add those overriding any duplicates from GET or POST
-			if (isset($request_headers['Authorization']) && substr($request_headers['Authorization'], 0, 6) == 'OAuth ') {
+			if (
+				isset($request_headers['Authorization'])
+				&& substr($request_headers['Authorization'], 0, 6) == 'OAuth '
+			) {
 				$header_parameters = Util::split_header(
 					$request_headers['Authorization']
 				);
@@ -354,8 +362,13 @@ public static function from_request(string $http_method = null, string $http_url
 	/**
 	 * pretty much a helper function to set up the request
 	 */
-	public static function from_consumer_and_token(Consumer $consumer, ?Token $token, string $http_method, string $http_url, array $parameters = null): self
-	{
+	public static function from_consumer_and_token(
+		Consumer $consumer,
+		?Token $token,
+		string $http_method,
+		string $http_url,
+		array $parameters = null
+	): self {
 		$parameters = $parameters ?: [];
 		$defaults = [
 			'oauth_version' => self::$version,
@@ -392,7 +405,7 @@ public function set_parameter(string $name, $value, bool $allow_duplicates = tru
 
 	public function get_parameter(string $name)
 	{
-		return isset($this->parameters[$name]) ? $this->parameters[$name] : null;
+		return $this->parameters[$name] ?? null;
 	}
 
 
@@ -465,7 +478,9 @@ public function get_normalized_http_url(): string
 		$parts = parse_url($this->http_url);
 
 		$scheme = (isset($parts['scheme'])) ? $parts['scheme'] : 'http';
-		$port = (isset($parts['port'])) ? $parts['port'] : (($scheme == 'https') ? '443' : '80');
+		$port = (isset($parts['port']))
+			? $parts['port']
+			: (($scheme == 'https') ? '443' : '80');
 		$host = (isset($parts['host'])) ? $parts['host'] : '';
 		$path = (isset($parts['path'])) ? $parts['path'] : '';
 
@@ -581,7 +596,7 @@ class Util
 	public static function urlencode_rfc3986($input)
 	{
 		if (is_array($input)) {
-			return array_map([__CLASS__, 'urlencode_rfc3986'], $input);
+			return array_map([self::class, 'urlencode_rfc3986'], $input);
 		} elseif (is_scalar($input)) {
 			return str_replace('+', ' ', str_replace('%7E', '~', rawurlencode((string) $input)));
 		} else {