-
-
Notifications
You must be signed in to change notification settings - Fork 4k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
feat: make search path for BinaryFinder customizable. #43968
base: master
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
@@ -11,15 +11,28 @@ | |||||||||||||||
use OCP\IBinaryFinder; | ||||||||||||||||
use OCP\ICache; | ||||||||||||||||
use OCP\ICacheFactory; | ||||||||||||||||
use OCP\IConfig; | ||||||||||||||||
use Symfony\Component\Process\ExecutableFinder; | ||||||||||||||||
|
||||||||||||||||
/** | ||||||||||||||||
* Service that find the binary path for a program | ||||||||||||||||
*/ | ||||||||||||||||
class BinaryFinder implements IBinaryFinder { | ||||||||||||||||
public const DEFAULT_BINARY_SEARCH_PATHS = [ | ||||||||||||||||
'/usr/local/sbin', | ||||||||||||||||
'/usr/local/bin', | ||||||||||||||||
'/usr/sbin', | ||||||||||||||||
'/usr/bin', | ||||||||||||||||
'/sbin', | ||||||||||||||||
'/bin', | ||||||||||||||||
'/opt/bin', | ||||||||||||||||
]; | ||||||||||||||||
private ICache $cache; | ||||||||||||||||
|
||||||||||||||||
public function __construct(ICacheFactory $cacheFactory) { | ||||||||||||||||
public function __construct( | ||||||||||||||||
ICacheFactory $cacheFactory, | ||||||||||||||||
private IConfig $config | ||||||||||||||||
) { | ||||||||||||||||
$this->cache = $cacheFactory->createLocal('findBinaryPath'); | ||||||||||||||||
} | ||||||||||||||||
|
||||||||||||||||
|
@@ -37,15 +50,10 @@ public function findBinaryPath(string $program) { | |||||||||||||||
if (\OCP\Util::isFunctionEnabled('exec')) { | ||||||||||||||||
$exeSniffer = new ExecutableFinder(); | ||||||||||||||||
// Returns null if nothing is found | ||||||||||||||||
$result = $exeSniffer->find($program, null, [ | ||||||||||||||||
'/usr/local/sbin', | ||||||||||||||||
'/usr/local/bin', | ||||||||||||||||
'/usr/sbin', | ||||||||||||||||
'/usr/bin', | ||||||||||||||||
'/sbin', | ||||||||||||||||
'/bin', | ||||||||||||||||
'/opt/bin', | ||||||||||||||||
]); | ||||||||||||||||
$result = $exeSniffer->find( | ||||||||||||||||
$program, | ||||||||||||||||
null, | ||||||||||||||||
$this->config->getSystemValue('binary_search_paths', self::DEFAULT_BINARY_SEARCH_PATHS)); | ||||||||||||||||
if ($result === null) { | ||||||||||||||||
$result = false; | ||||||||||||||||
} | ||||||||||||||||
Comment on lines
+55
to
59
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
An opportunity to streamline. :-) |
||||||||||||||||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,98 @@ | ||
<?php | ||
|
||
declare(strict_types = 1); | ||
/** | ||
* @copyright 2024 Reno Reckling <e-github@wthack.de> | ||
* @license GNU AGPL version 3 or any later version | ||
* | ||
* This program is free software: you can redistribute it and/or modify | ||
* it under the terms of the GNU Affero General Public License as | ||
* published by the Free Software Foundation, either version 3 of the | ||
* License, or (at your option) any later version. | ||
* | ||
* This program is distributed in the hope that it will be useful, | ||
* but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | ||
* GNU Affero General Public License for more details. | ||
* | ||
* You should have received a copy of the GNU Affero General Public License | ||
* along with this program. If not, see <http://www.gnu.org/licenses/>. | ||
* | ||
*/ | ||
|
||
namespace Test; | ||
|
||
use OC\BinaryFinder; | ||
use OC\Memcache\ArrayCache; | ||
use OCP\ICache; | ||
use OCP\ICacheFactory; | ||
use OCP\IConfig; | ||
|
||
class BinaryFinderTest extends TestCase { | ||
private ICache $cache; | ||
private ICacheFactory $cacheFactory; | ||
private $oldEnv; | ||
|
||
protected function setUp(): void { | ||
$this->oldEnv = getenv("PATH"); | ||
// BinaryFinder always includes the "PATH" environment variable into the search path, | ||
// which we want to avoid in this test because they are not usually found in webserver | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Thanks! Why should the path environment variable not be available in webserver deployments? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Apache does not set or pass it through by default. Phpfpm does not set it as well. Not sure about others but I would suspect that most servers don't provide it by default. |
||
// deployments. | ||
putenv('PATH=""'); | ||
$this->cacheFactory = $this->createMock(ICacheFactory::class); | ||
$this->cache = new ArrayCache(); | ||
$this->cacheFactory->method('createLocal')->with('findBinaryPath')->willReturn($this->cache); | ||
} | ||
|
||
protected function tearDown(): void { | ||
putenv('PATH='.$this->oldEnv); | ||
} | ||
|
||
public function testDefaultFindsCat() { | ||
$config = $this->createMock(IConfig::class); | ||
$config | ||
->method('getSystemValue') | ||
->with('binary_search_paths', $this->anything()) | ||
->will($this->returnCallback(function ($key, $default) { | ||
return $default; | ||
})); | ||
$finder = new BinaryFinder($this->cacheFactory, $config); | ||
$this->assertEquals($finder->findBinaryPath('cat'), '/usr/bin/cat'); | ||
$this->assertEquals($this->cache->get('cat'), '/usr/bin/cat'); | ||
} | ||
|
||
public function testDefaultDoesNotFindCata() { | ||
$config = $this->createMock(IConfig::class); | ||
$config | ||
->method('getSystemValue') | ||
->with('binary_search_paths', $this->anything()) | ||
->will($this->returnCallback(function ($key, $default) { | ||
return $default; | ||
})); | ||
$finder = new BinaryFinder($this->cacheFactory, $config); | ||
$this->assertFalse($finder->findBinaryPath('cata')); | ||
$this->assertFalse($this->cache->get('cata')); | ||
} | ||
|
||
public function testCustomPathFindsCat() { | ||
$config = $this->createMock(IConfig::class); | ||
$config | ||
->method('getSystemValue') | ||
->with('binary_search_paths', $this->anything()) | ||
->willReturn(['/usr/bin']); | ||
$finder = new BinaryFinder($this->cacheFactory, $config); | ||
$this->assertEquals($finder->findBinaryPath('cat'), '/usr/bin/cat'); | ||
$this->assertEquals($this->cache->get('cat'), '/usr/bin/cat'); | ||
} | ||
|
||
public function testWrongCustomPathDoesNotFindCat() { | ||
$config = $this->createMock(IConfig::class); | ||
$config | ||
->method('getSystemValue') | ||
->with('binary_search_paths') | ||
->willReturn(['/wrong']); | ||
$finder = new BinaryFinder($this->cacheFactory, $config); | ||
$this->assertFalse($finder->findBinaryPath('cat')); | ||
$this->assertFalse($this->cache->get('cat')); | ||
} | ||
} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can we assume people are clever enough to purge the local cache when changing the config?
Or should we add e.g.
md5(json_encode($this->config->getSystemValue('binary_search_paths')))
to the cache prefix?There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The cache is only for 5 minutes + we currently cache not found/fallback results and find that acceptable. So I don't think it's necessary.