Fix coding style according to owncloud/build/phpcs.xml

4 files changed, 128 insertions, 49 deletions

diff --git a/user_external/lib/base.php b/user_external/lib/base.php
index edaba71a9..b56bd73ba 100644
--- a/user_external/lib/base.php
+++ b/user_external/lib/base.php
@@ -1,11 +1,11 @@
 <?php
-namespace OCA\user_external;
 /**
  * Copyright (c) 2014 Christian Weiske <cweiske@cweiske.de>
  * This file is licensed under the Affero General Public License version 3 or
  * later.
  * See the COPYING-README file.
  */
+namespace OCA\user_external;
 use \OC_DB;
 
 /**
@@ -13,20 +13,31 @@ use \OC_DB;
  * on their first login in a local table.
  * This is required for making many of the user-related owncloud functions
  * work, including sharing files with them.
+ *
+ * @category Apps
+ * @package  UserExternal
+ * @author   Christian Weiske <cweiske@cweiske.de>
+ * @license  http://www.gnu.org/licenses/agpl AGPL
+ * @link     http://github.com/owncloud/apps
  */
 abstract class Base extends \OC_User_Backend{
 	protected $backend = '';
 
+	/**
+	 * Create new instance, set backend name
+	 *
+	 * @param string $backend Identifier of the backend
+	 */
 	public function __construct($backend) {
 		$this->backend = $backend;
 	}
 
 	/**
-	 * @brief delete a user
+	 * Delete a user
+	 *
 	 * @param string $uid The username of the user to delete
-	 * @return bool
 	 *
-	 * Deletes a user
+	 * @return bool
 	 */
 	public function deleteUser($uid) {
 		$query = OC_DB::prepare('DELETE FROM `*PREFIX*users_external` WHERE `uid` = ? AND `backend` = ?');
@@ -35,8 +46,10 @@ abstract class Base extends \OC_User_Backend{
 	}
 
 	/**
-	 * @brief get display name of the user
-	 * @param $uid user ID of the user
+	 * Get display name of the user
+	 *
+	 * @param string $uid user ID of the user
+	 *
 	 * @return string display name
 	 */
 	public function getDisplayName($uid) {
@@ -51,16 +64,18 @@ abstract class Base extends \OC_User_Backend{
 	}
 
 	/**
-	 * @brief Get a list of all display names
-	 * @returns array with  all displayNames (value) and the correspondig uids (key)
-	 *
 	 * Get a list of all display names and user ids.
+	 *
+	 * @return array with all displayNames (value) and the correspondig uids (key)
 	 */
 	public function getDisplayNames($search = '', $limit = null, $offset = null) {
 		$displayNames = array();
-		$query = OC_DB::prepare('SELECT `uid`, `displayname` FROM `*PREFIX*users_external`'
+		$query = OC_DB::prepare(
+			'SELECT `uid`, `displayname` FROM `*PREFIX*users_external`'
 			. ' WHERE (LOWER(`displayname`) LIKE LOWER(?) OR '
-			. 'LOWER(`uid`) LIKE LOWER(?)) AND `backend` = ?', $limit, $offset);
+			. 'LOWER(`uid`) LIKE LOWER(?)) AND `backend` = ?',
+			$limit, $offset
+		);
 		$result = $query->execute(array($search . '%', $search . '%', $this->backend));
 		$users = array();
 		while ($row = $result->fetchRow()) {
@@ -71,13 +86,15 @@ abstract class Base extends \OC_User_Backend{
 	}
 
 	/**
-	* @brief Get a list of all users
-	* @returns array with all uids
+	* Get a list of all users
 	*
-	* Get a list of all users.
+	* @return array with all uids
 	*/
 	public function getUsers($search = '', $limit = null, $offset = null) {
-		$query = OC_DB::prepare('SELECT `uid` FROM `*PREFIX*users_external` WHERE LOWER(`uid`) LIKE LOWER(?) AND `backend` = ?', $limit, $offset);
+		$query = OC_DB::prepare(
+			'SELECT `uid` FROM `*PREFIX*users_external` WHERE LOWER(`uid`) LIKE LOWER(?) AND `backend` = ?',
+			$limit, $offset
+		);
 		$result = $query->execute(array($search . '%', $this->backend));
 		$users = array();
 		while ($row = $result->fetchRow()) {
@@ -87,6 +104,8 @@ abstract class Base extends \OC_User_Backend{
 	}
 
 	/**
+	 * Determines if the backend can enlist users
+	 *
 	 * @return bool
 	 */
 	public function hasUserListings() {
@@ -94,16 +113,18 @@ abstract class Base extends \OC_User_Backend{
 	}
 
 	/**
-	 * @brief Set display name
-	 * @param $uid The username
-	 * @param $displayName The new display name
-	 * @returns true/false
-	 *
 	 * Change the display name of a user
+	 *
+	 * @param string $uid		 The username
+	 * @param string $displayName The new display name
+	 *
+	 * @return true/false
 	 */
 	public function setDisplayName($uid, $displayName) {
 		if ($this->userExists($uid)) {
-			$query = OC_DB::prepare('UPDATE `*PREFIX*users_external` SET `displayname` = ? WHERE LOWER(`uid`) = ? AND `backend` = ?');
+			$query = OC_DB::prepare(
+				'UPDATE `*PREFIX*users_external` SET `displayname` = ? WHERE LOWER(`uid`) = ? AND `backend` = ?'
+			);
 			$query->execute(array($displayName, $uid, $this->backend));
 			return true;
 		} else {
@@ -112,9 +133,11 @@ abstract class Base extends \OC_User_Backend{
 	}
 
 	/**
-	 * @brief Create user record in database
-	 * @param $uid The username
-	 * @returns void
+	 * Create user record in database
+	 *
+	 * @param string $uid The username
+	 *
+	 * @return void
 	 */
 	protected function storeUser($uid)
 	{
@@ -125,12 +148,16 @@ abstract class Base extends \OC_User_Backend{
 	}
 
 	/**
-	 * @brief check if a user exists
+	 * Check if a user exists
+	 *
 	 * @param string $uid the username
+	 *
 	 * @return boolean
 	 */
 	public function userExists($uid) {
-		$query = OC_DB::prepare('SELECT COUNT(*) FROM `*PREFIX*users_external` WHERE LOWER(`uid`) = LOWER(?) AND `backend` = ?');
+		$query = OC_DB::prepare(
+			'SELECT COUNT(*) FROM `*PREFIX*users_external` WHERE LOWER(`uid`) = LOWER(?) AND `backend` = ?'
+		);
 		$result = $query->execute(array($uid, $this->backend));
 		if (OC_DB::isError($result)) {
 			OC_Log::write('user_external', OC_DB::getErrorMessage($result), OC_Log::ERROR);
@@ -139,4 +166,3 @@ abstract class Base extends \OC_User_Backend{
 		return $result->fetchOne() > 0;
 	}
 }
-?>
diff --git a/user_external/lib/ftp.php b/user_external/lib/ftp.php
index 545d1e292..4e3ff85bd 100644
--- a/user_external/lib/ftp.php
+++ b/user_external/lib/ftp.php
@@ -6,11 +6,26 @@
  * See the COPYING-README file.
  */
 
+/**
+ * User authentication against a FTP/FTPS server
+ *
+ * @category Apps
+ * @package  UserExternal
+ * @author   Robin Appelman <icewind@owncloud.com>
+ * @license  http://www.gnu.org/licenses/agpl AGPL
+ * @link     http://github.com/owncloud/apps
+ */
 class OC_User_FTP extends \OCA\user_external\Base{
 	private $host;
 	private $secure;
 	private $protocol;
 
+	/**
+	 * Create new FTP authentication provider
+	 *
+	 * @param string  $host   Hostname or IP of FTP server
+	 * @param boolean $secure TRUE to enable SSL
+	 */
 	public function __construct($host,$secure=false) {
 		$this->host=$host;
 		$this->secure=$secure;
@@ -22,16 +37,19 @@ class OC_User_FTP extends \OCA\user_external\Base{
 	}
 
 	/**
-	 * @brief Check if the password is correct
-	 * @param $uid The username
-	 * @param $password The password
-	 * @returns true/false
-	 *
 	 * Check if the password is correct without logging in the user
+	 *
+	 * @param string $uid      The username
+	 * @param string $password The password
+	 *
+	 * @return true/false
 	 */
 	public function checkPassword($uid, $password) {
 		if (false === array_search($this->protocol, stream_get_wrappers())) {
-			OCP\Util::writeLog('user_external', 'ERROR: Stream wrapper not available: ' . $this->protocol, OCP\Util::ERROR);
+			OCP\Util::writeLog(
+				'user_external',
+				'ERROR: Stream wrapper not available: ' . $this->protocol, OCP\Util::ERROR
+			);
 			return false;
 		}
 		$url = sprintf('%s://%s:%s@%s/', $this->protocol, $uid, $password, $this->host);
diff --git a/user_external/lib/imap.php b/user_external/lib/imap.php
index 5168d3db2..19e792ddf 100644
--- a/user_external/lib/imap.php
+++ b/user_external/lib/imap.php
@@ -6,21 +6,36 @@
  * See the COPYING-README file.
  */
 
+/**
+ * User authentication against an IMAP mail server
+ *
+ * @category Apps
+ * @package  UserExternal
+ * @author   Robin Appelman <icewind@owncloud.com>
+ * @license  http://www.gnu.org/licenses/agpl AGPL
+ * @link     http://github.com/owncloud/apps
+ */
 class OC_User_IMAP extends \OCA\user_external\Base {
 	private $mailbox;
 
+	/**
+	 * Create new IMAP authentication provider
+	 *
+	 * @param string $mailbox PHP imap_open mailbox definition, e.g.
+	 *                        {127.0.0.1:143/imap/readonly}
+	 */
 	public function __construct($mailbox) {
 		parent::__construct($mailbox);
 		$this->mailbox=$mailbox;
 	}
 
 	/**
-	 * @brief Check if the password is correct
-	 * @param $uid The username
-	 * @param $password The password
-	 * @returns true/false
-	 *
 	 * Check if the password is correct without logging in the user
+	 *
+	 * @param string $uid      The username
+	 * @param string $password The password
+	 *
+	 * @return true/false
 	 */
 	public function checkPassword($uid, $password) {
 		if (!function_exists('imap_open')) {
diff --git a/user_external/lib/smb.php b/user_external/lib/smb.php
index 3f26177f5..e7f9b61b8 100644
--- a/user_external/lib/smb.php
+++ b/user_external/lib/smb.php
@@ -6,40 +6,60 @@
  * See the COPYING-README file.
  */
 
+/**
+ * User authentication via samba (smbclient)
+ *
+ * @category Apps
+ * @package  UserExternal
+ * @author   Robin Appelman <icewind@owncloud.com>
+ * @license  http://www.gnu.org/licenses/agpl AGPL
+ * @link     http://github.com/owncloud/apps
+ */
 class OC_User_SMB extends \OCA\user_external\Base{
 	private $host;
 
-	const smbclient='smbclient';
-	const loginError='NT_STATUS_LOGON_FAILURE';
+	const SMBCLIENT = 'smbclient';
+	const LOGINERROR = 'NT_STATUS_LOGON_FAILURE';
 
+	/**
+	 * Create new samba authentication provider
+	 *
+	 * @param string $host Hostname or IP of windows machine
+	 */
 	public function __construct($host) {
 		parent::__construct($host);
 		$this->host=$host;
 	}
 
 	/**
-	 * @brief Check if the password is correct
-	 * @param $uid The username
-	 * @param $password The password
-	 * @returns true/false
-	 *
 	 * Check if the password is correct without logging in the user
+	 *
+	 * @param string $uid      The username
+	 * @param string $password The password
+	 *
+	 * @return true/false
 	 */
 	public function checkPassword($uid, $password) {
 		$uidEscaped=escapeshellarg($uid);
 		$password=escapeshellarg($password);
 		$result=array();
-		$command=self::smbclient.' //'.$this->host.'/dummy -U'.$uidEscaped.'%'.$password;
+		$command=self::SMBCLIENT.' //'.$this->host.'/dummy -U'.$uidEscaped.'%'.$password;
 		$lastline = exec($command, $output, $retval);
 		if ($retval === 127) {
-			OCP\Util::writeLog('user_external', 'ERROR: smbclient executable missing', OCP\Util::ERROR);
+			OCP\Util::writeLog(
+				'user_external', 'ERROR: smbclient executable missing',
+				OCP\Util::ERROR
+			);
 			return false;
-		} else if (strpos($lastline, self::loginError) !== false) {
+		} else if (strpos($lastline, self::LOGINERROR) !== false) {
 			//normal login error
 			return false;
 		} else if ($retval != 0) {
 			//some other error
-			OCP\Util::writeLog('user_external', 'ERROR: smbclient error: ' . trim($lastline), OCP\Util::ERROR);
+			OCP\Util::writeLog(
+				'user_external', 'ERROR: smbclient error: ' . trim($lastline),
+				OCP\Util::ERROR
+			);
 			return false;
 		} else {
 			$this->storeUser($uid);