@@ -23,115 +23,8 @@ It allows you to create a new environment from scratch without impacting the sou
23
23
offers the ability to have a global overview of all installed environments and perform actions without having to be in
24
24
the project directory. Native commands are still available since this is a wrapper of [ Docker Compose] [ docker-compose ] .
25
25
26
- ## 📦 Prerequisites
27
- * [ Docker] [ docker-engine ] and [ Docker Compose] [ docker-compose ] .
28
- * [ Mutagen] [ mutagen ] to improve performance because Docker can be [ painfully slow on macOS] [ issue ] with some projects.
29
- * [ mkcert] [ mkcert ] (optional) to make locally trusted development certificates because the HTTPS has become the norm.
30
-
31
- ** Last but not least, this package currently only supports macOS** .
32
-
33
- ## 🛠 Installing
34
- You can install ` origami ` with Composer like any PHP dependency.
35
- ``` shell script
36
- composer global require ajardin/origami
37
- ```
38
-
39
- Once you have installed the binary, you can check the status of the application requirements.
40
- ``` shell script
41
- origami --verbose
42
- ```
43
-
44
- ## 🚀 Getting Started
45
- 1 . Open a terminal in the directory of your project
46
- 2 . Run ` origami install `
47
- 3 . Configure the environment of your choice
48
- 4 . Run ` origami start `
49
- 5 . Open your favorite browser on your custom domain or https://127.0.0.1/
50
-
51
- The ` var/docker/ ` directory of your project contains the environment configuration. Feel free to edit it at your
52
- convenience; it is your configuration now. 😉
53
-
54
- ## 🪄 Available Commands
55
-
56
- ### ` origami configure:phpstorm `
57
- Copies the PhpStorm configuration associated to the current environment.
58
-
59
- ### ` origami data `
60
- Shows real-time usage statistics of the running environment.
61
-
62
- ### ` origami database:dump `
63
- Generates a database dump of the running environment.
64
-
65
- ### ` origami:database:reset `
66
- Recreates the database volume of the running environment.
67
-
68
- ### ` origami database:restore `
69
- Restores a database dump of the running environment.
70
-
71
- ### ` origami debug `
72
- Shows system information and the configuration of the current environment.
73
-
74
- ### ` origami install `
75
- Installs an environment for the project in the current directory.
76
-
77
- ### ` origami logs [--tail=XX] [service] `
78
- Shows the logs generated in real-time by the running environment.
79
-
80
- By default, this command only shows new entries. You can use the ` --tail=XX ` option to view previous entries, and filter
81
- the output by specifying the name of a service (` php ` for example).
82
-
83
- ### ` origami php `
84
- Opens a terminal on the ` php ` service to interact with it.
85
-
86
- ### ` origami prepare `
87
- Prepares Docker images (i.e. pull and build) of a previously installed environment.
88
-
89
- ### ` origami ps `
90
- Shows the status of the running environment services.
91
-
92
- ### ` origami registry `
93
- Shows the list and status of all previously installed environments.
94
-
95
- ### ` origami restart `
96
- Restarts an environment previously started.
97
-
98
- ### ` origami root `
99
- Shows instructions for configuring your terminal to manually use Docker commands.
100
-
101
- ### ` origami start `
102
- Starts an environment previously installed.
103
-
104
- ### ` origami stop `
105
- Stops an environment previously started.
106
-
107
- ### ` origami uninstall `
108
- Uninstalls an environment by deleting all Docker data and associated configuration.
109
-
110
- You can either run this command from the directory where the project has been installed, or pass its name as an
111
- argument to the command.
112
-
113
- ### ` origami update `
114
- Updates the configuration of a previously installed environment.
115
-
116
- This command must be run after each ` origami ` update to ensure that you benefit from all the latest improvements.
117
- ** Your manual changes are overwritten by this action.**
118
-
119
- ## 🔍 Architecture
120
- ` origami ` relies on [ Symfony] [ symfony ] , a popular PHP framework.
121
-
122
- Unlike common Symfony projects, we use [ Box] [ box ] to package the tool into a single binary file so that it's possible to
123
- share it without installing all its dependencies. Otherwise, it could potentially bring conflicts if other tools with
124
- outdated dependencies are present on the local machine.
125
-
126
- ** Why PHP?** The main reason is that ` origami ` will focus on environments dedicated to PHP applications, and we would
127
- like to facilitate the contribution process by using something well-known by our end-users.
128
-
129
- ## ✅ Testing
130
- There is a ` Makefile ` with the most useful commands (e.g. fixing the coding style or running the tests).
131
-
132
- ``` shell script
133
- make
134
- ```
26
+ ## 📚 Documentation
27
+ To discover how to install and use ` origami ` , please have a look at the [ wiki page] [ wiki ] .
135
28
136
29
## 🤝 Contributing
137
30
Contributions, issues and feature requests are welcome! Feel free to check [ issues page] [ contributions ] .
@@ -153,3 +46,4 @@ Copyright © [Alexandre Jardin][me]. `origami` is an open-sourced software licen
153
46
[ orocommerce ] : https://oroinc.com/
154
47
[ sylius ] : https://sylius.com/
155
48
[ symfony ] : https://symfony.com/
49
+ [ wiki ] : https://github.com/origamiphp/source/wiki
0 commit comments