Keep Track of Model Inventory with Laravel Stock

 Laravel Stock is a package by Appstract for keeping track of inventory counts on models:

Keep stock for Eloquent models. This package will track stock mutations for your models. You can increase, decrease, clear, and set stock. It’s also possible to check if a model is in stock (on a certain date/time).

For example, let’s say you have a Book model with which you need to keep track of stock:

1use Appstract\Stock\HasStock;
2 
3class Book extends Model
4{
5    use HasStock;
6}

When a customer places an order for a book, you can change the stock counts:

1$book->increaseStock(10);
2$book->decreaseStock(10);
3 
4// Change stock positively or negatively with one method
5$book->mutateStock(10);
6$book->mutateStock(-10);

Next, in your UI you could check to see if a product is in stock:

1$book->inStock();
2// See if you have at least 10 of the same book in stock
3$book->inStock(10);

Finally, you can clear stock out:

1$book->clearStock();
2 
3// Clear stock and then set a new value
4$book->clearStock(10);

You can learn more about this package, get full installation instructions, and view the source code on GitHub at appstract/laravel-stock.

Read More

Terminal: An Elegant Wrapper around the Symfony Process Component

 Terminal is a neat PHP package by Titas Gailius that provides a “wrapper around Symfony’s Process component.” It has a fluent interface, which makes running terminal commands a breeze:

1Terminal::in(storage_path('sites/123'))
2    ->timeout(120)
3    ->retries(3)
4    ->run('wp cli update');

In the most simple form, a command might look like the following—which removes a lot of boilerplate and lower-level details of the wonderful Symfony Process component:

1$response = Terminal::run('rm -rf vendor');

Here are some things you can do with the response from the run command:

 1$response->code() : int;
 2$response->ok() : bool;
 3$response->successful() : bool;
 4 
 5$response->lines() : array;
 6$response->output() : string;
 7(string) $response: string;
 8 
 9// Terminal captures exceptions that you can throw
10$response->throw();
11 
12// You can access the symfony process
13$response->process();
14 
15// All calls not found on the Response are passed to Symfony process
16// \Symfony\Component\Process\Process::isRunning()
17$response->isRunning();

Here are a few more neat examples from the readme:

 1// Passing data to the command
 2Terminal::with([
 3    'firstname' => 'John',
 4    'lastname' => 'Doe',
 5])->run('echo Hello, {{ $firstname}} {{ $lastname }}');
 6 
 7// Retries and duration between each retry
 8Terminal::retries(3, 100)->run('rm -rf vendor');
 9 
10// Environment variables
11Terminal::withEnvironmentVariables([
12    'APP_ENV' => 'testing',
13])->run('rm -rf $DIRECTORY');

You can learn more about this package, get full installation instructions, and view the source code on GitHub at TitasGailius/terminal.

Read More