blacksmith - GitLite

KO | EN

gitlite — search

#javascript #python #typescript #llm #go #golang #machine-learning #linux #docker #cli #kubernetes #awesome-list #vue #ios

blacksmith

(★ 103)

The unofficial Laravel Forge PHP API

파일 탐색기

최종 버전 다운로드 (.zip)

- servers.md
.gitignore
blacksmith
composer.json
phpunit.xml
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/mpociot/blacksmith

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd blacksmith

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. PHP (Composer)

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
PHP PHP 실행 환경이 필요합니다.
Composer PHP 라이브러리 설치를 위한 패키지 매니저입니다.

$site->installApp($repository, $provider = 'github', $branch = 'master', $composer = true, $migrate = false);

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ php -S localhost:8000 같은 내장 서버로 실행한 뒤 브라우저에서 http://localhost:8000 으로 접속해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Blacksmith - The unofficial Laravel Forge PHP API

Laravel Forge is **awesome**, right? 
Yes it is - but there's one thing it's missing - a proper API.

That's why this library exists - Blacksmith is an unofficial [Laravel Forge API](http://forge.laravel.com) to automate common tasks.

The API is still improving and I will keep adding features, as I need them.

## Getting Started

```php
use Mpociot\Blacksmith\Blacksmith;

$blacksmith = new Blacksmith($email, $password);

```

## Available methods

### Get all active servers

Returns a Collection of `Server` objects.

```php
$activeServers = $blacksmith->getActiveServers();
```

### Get all sites for all servers

Returns a Collection of `Site` objects.

```php
$sites = $blacksmith->getSites();
```

### Get a server by its ID

Returns a single `Server` object.

```php
$server = $blacksmith->getServer(1);
```

### Add a server to Forge

Returns a single `Server` object with a provision url.

The following example will create a Load Balancer with a custom provider
```php
$server = $blacksmith->addServer([
    'backups' => false,
    'database' => 'forge',
    'hhvm' => false,
    'ip_address' => '94.212.124.121',
    'maria' => false,
    'name' => 'harmonious-lagoon',
    'nodeBalancer' => true,
    'old_php' => false,
    'php_version' => 'php70',
    'private_ip_address' => '10.0.0.2',
    'provider' => 'custom',
    'size' => '2',
    'timezone' => 'Europe/Berlin',
]);
```

### Get a site by its ID

Returns a single `Site` object.

```php
$site = $blacksmith->getSite(1);
```

### Get all circles

Returns a Collection of `Circle` objects of the user.

```php
$circles = $blacksmith->getCircles();
```

### Get a circle by its ID

Returns a single `Circle` object.

```php
$circle = $blacksmith->getCircle(1);
```

### Add a new circle

Returns a single `Circle` object.

```php
$circle = $blacksmith->addCircle('Name of Circle');
```

### Get all recipes

Returns a Collection of `Recipe` objects.

```php
$recipes = $blacksmith->getRecipes();
```

### Get a recipe by its ID

Returns a single `Recipe` object.

```php
$recipe = $blacksmith->getRecipe(1);
```

### Add a new recipe

Returns a single `Recipe` object.

```php
$recipe = $blacksmith->addRecipe('RecipeName', 'root', 'Recipe contents');
```

## Server methods

### Get Sites

Returns a Collection of `Site` objects for the server.

```php
$sites = $server->getSites();
```

### Add a new site

Returns a the newly created `Site` object or throws an exception if errors occur.

```php
$newSite = $server->addSite($site_name, $project_type = 'php', $directory = '/public', $wildcards = false);
```

### Add a new SSH key

Add a SSH key to a server

```php
$server->addSSHKey('Name SSH key', 'Contents of SSH key');
```

### Remove a SSH key from a server

```php
$server->removeSSHKey(1);
```

### Update Metadata

Update the metadata of the current site, and return an updated `Server` object or throws an exception if errors occur.

```php
$server = $server->updateMetadata($server_name, $ip_address, $private_ip_address, $size);
```

### Get Schedules Jobs

Returns a Collection of `ScheduledJob` objects for the server.

```php
$jobs = $server->getScheduledJobs();
```

### Add a new scheduled job

Returns a the newly created `ScheduledJob` object or throws an exception if errors occur.

```php
$newJob = $server->addScheduledJob($command, $user = 'forge', $frequency = 'minutely');
```

### toArray

Returns an array containing all available server information.

```php
$data = $server->toArray();
```

## Site methods

### Get Environment

Returns the configured .env file

```php
$env_content = $site->getEnvironment();
```

### Install an application

Install and deploy an application to the site.

```php
$site->installApp($repository, $provider = 'github', $branch = 'master', $composer = true, $migrate = false);
```

### Deploy an application

Deploys an application on this site.

```php
$site->deploy();
```

### Get last deployment log

Returns the last deployment log for this site.

```php
$site->deployLog();
```

### toArray

Returns an array containing all available site information.

```php
$data = $site->toArray();
```

## Circle methods

### Invite a member by email

Returns a fresh `Circle` object or throws an exception if errors occur.

```php
$circle = $circle->inviteMember('email@company.com');
```

### Set all circle members

If you want to delete a member you update a circle with all member id's.
It return a fresh `Circle` object.

```php
$circle = $circle->setMembers([1,2]);
```

### Set all circle servers

If you want to add or delete a server from the circle you update a circle with all server id's.
It return a fresh `Circle` object.

```php
$circle = $circle->setServers([1,2]);
```

## Recipe methods

### Update a Recipe

```php
$recipe = $recipe->update($name, $user, $script);
```

## License

Blacksmith is free software distributed under the terms of the MIT license.