https://github.com/maximgrynykha/winkill
⚙️ Scan & Kill Windows processes in PHP
https://github.com/maximgrynykha/winkill
kill operating-system os php process processes scan tasklist terminate windows winkill
Last synced: 5 months ago
JSON representation
⚙️ Scan & Kill Windows processes in PHP
- Host: GitHub
- URL: https://github.com/maximgrynykha/winkill
- Owner: maximgrynykha
- License: mit
- Created: 2021-04-18T16:01:35.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-05-18T18:26:51.000Z (about 2 years ago)
- Last Synced: 2025-07-11T03:52:27.401Z (11 months ago)
- Topics: kill, operating-system, os, php, process, processes, scan, tasklist, terminate, windows, winkill
- Language: PHP
- Homepage:
- Size: 107 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# __Winkill__
Work with processes as objects. Find specific ones by attributes and kill them.
## ⚙️ Installation
To install this library - run the command below in your terminal:
```shell
composer require maximgrynykha/winkill
```
## Usage
```php
scan();
```
```php
// Get scanned processes
$scanned = $processes->get();
dd($scanned);
```
```php
// Select specific process(es)
$selected = $processes->where(
attribute: 'process_name',
compareAs: '=',
value: 'phpstorm64.exe'
)->get();
dd($selected);
```
```php
// Kill specific process(es)
$killed = $processes->where(
attribute: 'process_id',
compareAs: '=',
value: 11492
)->kill();
// Note: If the processes have been killed or not found
// by the where-condition then returns an empty array.
dd($killed);
```
```php
} catch (\Winkill\Kernel\Interface\Exception|\Throwable $throwable) {
die($throwable->getMessage());
}
```
### API (based on 'tasklist' command)
| Attribute name | Attribute value | Example | Compare operator |
|:------------------|:--------------------------------|:-----------|:------------------------------------------|
| `process_name` | [string]: name with ext | chrome.exe | [string]: `=`, `!=` |
| | [string]: name | chrome | [string]: `=`, `!=` |
| | [string]: ext | .exe | [string]: `=`, `!=` |
| `process_id` | [int]: number of the ID | | [string]: `=`, `!=` |
| `session_name` | [string]: Console / Services | | [string]: `=`, `!=` |
| `session_number` | [int]: number in range of {0-1} | | [string]: `=`, `!=` |
| `consumed_memory` | [int]: number in Kb (kilobytes) | | [string]: `>`, `<`, `=`, `>=`, `<=`, `!=` |
### Select processes
```php
$processes->where('process_name', '=', 'chrome')->get();
$processes->where('process_id', '=', 11455)->get();
$processes->where('session_name', '=', 'console')->get();
$processes->where('session_number', '=', 1)->get();
// ⚠️ Note: consumed memory is estimated in Kb(kilobytes)
$processes->where('consumed_memory', '=', 128920)->get();
```
### Terminate processes
```php
$processes->where('process_name', '=', 'chrome')->kill();
$processes->where('process_id', '=', 11455)->kill();
//❗Alert: killing process(es) by attribute [session_name]
// may break you 🤯 and/or your computer 💥. Use it only
// if you are 100% confident at the ending result.
$processes->where('session_name', '=', 'console')->kill();
//❗Alert: killing process(es) by attribute [session_number]
// is the same danger as was said previously about attribute
// [session_name], so be warned about using it at your risk.
$processes->where('session_number', '=', 1)->kill();
// ⚠️ Note: consumed memory is estimated in Kb(kilobytes)
$processes->where('consumed_memory', '=', 128920)->kill();
```
### 🧱 Snippets
```php
// Terminate processes by an array of process names (all names are an example)
array_walk($processes_names = ['chrome', 'firefox', 'slack'],
static fn(string $process_name): Process =>
$processes->where('process_name', '=', $process_name)->kill(),
);
// Terminate processes by an array of process ids (all ids are an example)
array_walk($processes_ids = [1000, 5595, 17820],
static fn(string $process_id): Process =>
$processes->where('process_id', '=', $process_id)->kill(),
);
// You can switch between array_walk and array_map for your needs.
// [Confusing in difference?](https://stackoverflow.com/a/3432266/11591375)
```
```php
$processes = $processes->where('consumed_memory', '<', 1000)->get();
// Sort processes on consumed memory by ASC
usort($processes, static fn(Process $process, Process $_process): int =>
$process->consumed_memory <=> $_process->consumed_memory
);
// Sort processes on consumed memory by DESC
usort($processes, static fn(Process $process, Process $_process): int =>
$_process->consumed_memory <=> $process->consumed_memory
);
```
## 📝 Footnotes
_The project utilizes `DRY` and `SOLID` principles. Used `Design Patterns` are listed below._
| Creational | Structural | Behavioral | Others* |
|---------------------------------------------------------------------------------|:------------------------------------------------------------|:----------------------------------------------------------------|:------------------------------------------------------------------------|
| [`Abstract Factory`](https://refactoring.guru/design-patterns/abstract-factory) | [`Facade`](https://refactoring.guru/design-patterns/facade) | [`Strategy`](https://refactoring.guru/design-patterns/strategy) | [`Composition Root`](https://blog.ploeh.dk/2011/07/28/CompositionRoot/) |
| [`Factory Method`](https://refactoring.guru/design-patterns/factory-method) | [`Proxy`](https://refactoring.guru/design-patterns/proxy) | [`Command`](https://refactoring.guru/design-patterns/command) | |
| [`Builder`](https://refactoring.guru/design-patterns/builder) | | | |
## 🤝 Contributing
If you have a problem that cannot be solved using this library, please write your solution, and if you want to help
other developers who also use this library (or if you want to keep your solution working after a new version is
released, which will be in the package manager dependencies) — create a pull-request. I will be happy to add your
excellent code to the library!
🐞 Report any bugs or issues you find on the [GitHub issues](https://github.com/MaximGrynykha/winkill/issues).
## 📃 License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.