Updated agentzero::getHints() to enable the hints to be extracted from a headers array or from $_SERVER.

Improved logic in `versions::get()`.
Added some `ClaudeBot` tests.

Author: hexydec

src/agentzero.php

@@ -150,7 +150,18 @@ public function __get(string $key) : string|int|null {
 	 * 
 	 * @return array<string,string> An array containing relevant client hints sent by the client
 	 */
-	public static function getHints() : array {
+	public static function getHints(?array $headers = null) : array {
+
+		// get from $_SERVER
+		if ($headers === null) {
+			$values = $_SERVER;
+			$prefix = 'HTTP_';
+		} else {
+			$values = [];
+			foreach ($headers AS $key => $item) {
+				$values[\strtoupper(\str_replace('-', '_', $key))] = $item;
+			}
+		}
 		$hints = [
 			'sec-ch-ua-mobile',
 			'sec-ch-ua-full-version-list',
@@ -164,8 +175,8 @@ public static function getHints() : array {
 		$data = [];
 		foreach ($hints AS $item) {
 			$upper = \strtoupper(\str_replace('-', '_', $item));
-			if (!empty($_SERVER['HTTP_'.$upper])) {
-				$data[$item] = $_SERVER['HTTP_'.$upper];
+			if (!empty($values[$prefix.$upper])) {
+				$data[$item] = $values[$prefix.$upper];
 			}
 		}
 		return $data;

src/helpers/versions.php

@@ -105,10 +105,9 @@ public static function get(string $browser, string $version, array $config) : ar
 		$life = $config['versionscachelife'];
 		if ($cache !== null && ($versions = self::load($source, $cache, $life)) !== false) {
 			$data = [];
-			if (isset($versions[$browser])) {
 
-				// get latest version of the browser
-				$data['browserlatest'] = self::latest($versions[$browser], $config['currentdate']);
+			// get latest version of the browser
+			if (isset($versions[$browser]) && ($data['browserlatest'] = self::latest($versions[$browser], $config['currentdate'])) !== null) {
 
 				// check if version is greater than latest version
 				$major = \intval($version);
@@ -142,7 +141,7 @@ public static function get(string $browser, string $version, array $config) : ar
 					$data['browserreleased'] = self::released($versions[$browser], $version);
 
 					// calculate status
-					if (isset($data['browserreleased'])) {
+					if (isset($data['browserreleased'], $data['browserlatest'])) {
 						$current = \explode('.', $data['browserlatest'])[0] === \explode('.', $version)[0];
 						$released = new \DateTime($data['browserreleased']);
 

tests/crawlersTest.php

@@ -1649,6 +1649,59 @@ public function testAi() : void {
 				'appname' => 'PerplexityBot',
 				'appversion' => '1.0',
 				'url' => 'https://perplexity.ai/perplexitybot'
+			],
+			'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36; ClaudeBot/1.0; +claudebot@anthropic.com)' => [
+				'string' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36; ClaudeBot/1.0; +claudebot@anthropic.com)',
+				'type' => 'robot',
+				'category' => 'ai',
+				'vendor' => 'Apple',
+				'device' => 'Macintosh',
+				'processor' => 'Intel',
+				'architecture' => 'x86',
+				'bits' => 64,
+				'kernel' => 'Linux',
+				'platform' => 'Mac OS X',
+				'platformversion' => '10.15.7',
+				'engine' => 'Blink',
+				'engineversion' => '131.0.0.0',
+				'browser' => 'Chrome',
+				'browserversion' => '131.0.0.0',
+				'browserreleased' => '2025-01-22',
+				'app' => 'Claude Bot',
+				'appname' => 'ClaudeBot',
+				'appversion' => '1.0'
+			],
+			'ClaudeBot/1.0 (web crawler; +https://www.anthropic.com/; claudebot@anthropic.com)' => [
+				'string' => 'ClaudeBot/1.0 (web crawler; +https://www.anthropic.com/; claudebot@anthropic.com)',
+				'type' => 'robot',
+				'category' => 'ai',
+				'app' => 'Claude Bot',
+				'appname' => 'ClaudeBot',
+				'appversion' => '1.0',
+				'url' => 'https://www.anthropic.com/'
+			],
+			'Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +support@anthropic.com)' => [
+				'string' => 'Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +support@anthropic.com)',
+				'type' => 'robot',
+				'category' => 'ai',
+				'app' => 'Claude Bot',
+				'appname' => 'ClaudeBot',
+				'appversion' => '1.0'
+			],
+			'ClaudeBot' => [
+				'string' => 'ClaudeBot',
+				'type' => 'robot',
+				'category' => 'ai',
+				'app' => 'Claude Bot',
+				'appname' => 'ClaudeBot'
+			],
+			'Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)' => [
+				'string' => 'Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)',
+				'type' => 'robot',
+				'category' => 'ai',
+				'app' => 'Claude Bot',
+				'appname' => 'ClaudeBot',
+				'appversion' => '1.0'
 			]
 		];
 		foreach ($strings AS $ua => $item) {