Added support for Microsoft Concept Graph

Author: web64

corenlp.json

@@ -0,0 +1,13 @@
+<?php
+
+require "vendor/autoload.php";
+
+$concept = new \Web64\Nlp\MsConcept;
+$concept->debug = true;
+
+$res = $concept->get('php');
+print_r( $res );
+
+echo "\nGet Score by NPMI:\n";
+$res = $concept->limit(3)->scoreBy('ScoreByNPMI')->smooth(0.0001)->get('php');
+print_r( $res );

examples/concept.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace Web64\Nlp;
+
+/**
+ * Microsoft Concept Graph For Short Text Understanding
+ *   - Documentation: https://concept.research.microsoft.com/
+ *   - Example: https://concept.research.microsoft.com/api/Concept/ScoreByProb?instance=catalonia&topK=10&smooth=1
+ */
+class MsConcept
+{
+    private $api_url = "https://concept.research.microsoft.com/api/Concept/";
+    private $limit = 10;
+    private $smooth = 0.0004;
+    private $score_by = 'ScoreByProb';
+    public $debug = false;
+
+    public function limit( $limit )
+    {
+        $this->limit = (int)$limit;
+
+        return $this;
+    }
+
+    public function scoreBy( $score_by )
+    {
+        $this->score_by = $score_by;
+        return $this;
+    }
+
+    public function smooth( $smooth )
+    {
+        $this->smooth = $smooth;
+        return $this;
+    }
+
+    // , $num_results = 10, $score_method = 'ScoreByProb', $smooth = 0.0001
+    public function get( $word )
+    {
+        $url = $this->api_url . $this->score_by . "?instance=" . urlencode($word) . "&topK=". $this->limit . "&smooth=". $this->smooth;
+
+        return $this->call( $url );
+    }
+
+    public function call( $url )
+    {
+        if ( $this->debug ) echo "URL: $url \n";
+
+        $context_params = array(
+                'http' => array(
+                    'method' => 'GET',
+                    'header' => "Content-Type: application/json\r\n",
+            )
+        );
+        
+        $context = stream_context_create( $context_params );
+        $response = file_get_contents($url, FALSE, $context);
+        return json_decode($response, 1);  
+    }
+}

src/MsConcept.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace Tests\Unit;
+
+use Tests\TestCase;
+
+class ConceptTest extends TestCase 
+{
+    /** @test */
+    public function get_concepts_for_words()
+    {
+        $concept = new \Web64\Nlp\MsConcept;
+        $res = $concept->get('php');
+
+        $this->assertNotEmpty( $res );
+
+        $this->assertEquals( 'language', key($res) );
+        
+    }
+
+    /** @test */
+    public function score_by_npmi()
+    {
+        $concept = new \Web64\Nlp\MsConcept;
+        $res = $concept->limit(3)->scoreBy('ScoreByNPMI')->smooth(0.0001)->get('php');
+
+        $this->assertNotEmpty( $res );
+        $this->assertEquals( 3, count($res) );
+
+        $this->assertEquals( 'programming language', key($res) ); 
+    }
+}