wiki.techinc.nl/includes/ExtensionInfo.php
Reedy 7dd416484a Allow extensions (et al) to have multiple LICENSE/COPYING files
Bug: T251642
Change-Id: I25f4df5a5b03d2e9bdf7b9997db00a986d252a9b
2020-05-05 22:49:04 +00:00

66 lines
1.4 KiB
PHP

<?php
namespace MediaWiki;
/**
* @since 1.35
*/
class ExtensionInfo {
/**
* Obtains the full path of a AUTHORS or CREDITS file if one exists.
*
* @param string $dir Path to the root directory
*
* @since 1.35
*
* @return bool|string False if no such file exists, otherwise returns
* a path to it.
*/
public static function getAuthorsFileName( $dir ) {
if ( !$dir ) {
return false;
}
foreach ( scandir( $dir ) as $file ) {
$fullPath = $dir . DIRECTORY_SEPARATOR . $file;
if ( preg_match( '/^(AUTHORS|CREDITS)(\.txt|\.wiki|\.mediawiki)?$/', $file ) &&
is_readable( $fullPath ) &&
is_file( $fullPath )
) {
return $fullPath;
}
}
return false;
}
/**
* Obtains the full paths of COPYING or LICENSE files if they exist.
*
* @param string $extDir Path to the extensions root directory
*
* @since 1.35
*
* @return array Returns an array of zero or more paths.
*/
public static function getLicenseFileNames( $extDir ) {
if ( !$extDir ) {
return [];
}
$licenseFiles = [];
foreach ( scandir( $extDir ) as $file ) {
$fullPath = $extDir . DIRECTORY_SEPARATOR . $file;
// Allow files like GPL-COPYING and MIT-LICENSE
if ( preg_match( '/^([\w\.-]+)?(COPYING|LICENSE)(\.txt)?$/', $file ) &&
is_readable( $fullPath ) &&
is_file( $fullPath )
) {
$licenseFiles[] = $fullPath;
}
}
return $licenseFiles;
}
}