Merge commit 'be3e8236086165e5e45a5a10783823874b3f3ebd' as 'lib/vscode'

lib/vscode/extensions/php-language-features/src/features/hoverProvider.ts

@@ -0,0 +1,35 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import { HoverProvider, Hover, MarkedString, TextDocument, CancellationToken, Position, workspace } from 'vscode';
+import { textToMarkedString } from './utils/markedTextUtil';
+import phpGlobals = require('./phpGlobals');
+import phpGlobalFunctions = require('./phpGlobalFunctions');
+
+export default class PHPHoverProvider implements HoverProvider {
+
+	public provideHover(document: TextDocument, position: Position, _token: CancellationToken): Hover | undefined {
+		let enable = workspace.getConfiguration('php').get<boolean>('suggest.basic', true);
+		if (!enable) {
+			return undefined;
+		}
+
+		let wordRange = document.getWordRangeAtPosition(position);
+		if (!wordRange) {
+			return undefined;
+		}
+
+		let name = document.getText(wordRange);
+
+		let entry = phpGlobalFunctions.globalfunctions[name] || phpGlobals.compiletimeconstants[name] || phpGlobals.globalvariables[name] || phpGlobals.keywords[name];
+		if (entry && entry.description) {
+			let signature = name + (entry.signature || '');
+			let contents: MarkedString[] = [textToMarkedString(entry.description), { language: 'php', value: signature }];
+			return new Hover(contents, wordRange);
+		}
+
+		return undefined;
+	}
+}