Skip to content

Commit f328760

Browse files
authored
Update README.md
1 parent b352f41 commit f328760

File tree

1 file changed

+58
-2
lines changed

1 file changed

+58
-2
lines changed

README.md

Lines changed: 58 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,58 @@
1-
# generate-php-project-classes-list-file-action
2-
GitHub action to generate a file with PHP project classes list (works only with composer projects)
1+
[![License](https://img.shields.io/github/license/impresscms-dev/generate-php-project-classes-list-file-action.svg)](LICENSE)
2+
[![GitHub release](https://img.shields.io/github/release/impresscms-dev/generate-php-project-classes-list-file-action.svg)](https://github.com/impresscms-dev/generate-php-project-classes-list-file-action/releases)
3+
4+
# Generate PHP project classes list file action
5+
6+
GitHub action to generate a file with [PHP](https://php.net) project classes list (works only with [composer](https://getcomposer.org) projects)
7+
8+
## Usage
9+
10+
To use this action in your project, create workflow in your project similar to this code (Note: some parts and arguments needs to be altered):
11+
```yaml
12+
name: Automatic update project documentation
13+
14+
on:
15+
push:
16+
17+
jobs:
18+
get_php_classes_list:
19+
runs-on: ubuntu-latest
20+
steps:
21+
- name: Checkouting project code...
22+
uses: actions/checkout@v2
23+
24+
- name: Install PHP
25+
uses: shivammathur/setup-php@master
26+
with:
27+
php-version: 8.1
28+
extensions: curl, gd, pdo_mysql, json, mbstring, pcre, session
29+
ini-values: post_max_size=256M
30+
coverage: none
31+
tools: composer:v2
32+
33+
- name: Install Composer dependencies (with dev)
34+
run: composer install --no-progress --no-suggest --prefer-dist --optimize-autoloader
35+
36+
- name: Getting PHP classes list...
37+
uses: impresscms-dev/[email protected]
38+
with:
39+
output_file: ./php-classes.lst
40+
41+
- uses: actions/upload-artifact@v3
42+
with:
43+
name: my-artifact
44+
path: ./php-classes.lst
45+
```
46+
47+
## Arguments
48+
49+
This action supports such arguments (used in `with` keyword):
50+
| Argument | Required | Default value | Description |
51+
|-------------|----------|----------------------|-----------------------------------|
52+
| output_file | Yes | | File where to write classes list |
53+
54+
## How to contribute?
55+
56+
If you want to add some functionality or fix bugs, you can fork, change and create pull request. If you not sure how this works, try [interactive GitHub tutorial](https://try.github.io).
57+
58+
If you found any bug or have some questions, use [issues tab](https://github.com/impresscms-dev/generate-php-project-classes-list-file-action/issues) and write there your questions.

0 commit comments

Comments
 (0)