Commit 7552f01d0f2c1c0130d84a83afbc08924a4b87ab

Authored by 王子强
0 parents

add drupal

Too many changes to show.

To preserve performance only 6 of 34 files are displayed.

  1 +#
  2 +# Copy and rename this file to .env at root of this project.
  3 +#
  4 +
  5 +# A common use case is to supply database creds via the environment. Edit settings.php
  6 +# like so:
  7 +#
  8 +# $databases['default']['default'] = [
  9 +# 'database' => getenv('MYSQL_DATABASE'),
  10 +# 'driver' => 'mysql',
  11 +# 'host' => getenv('MYSQL_HOSTNAME'),
  12 +# 'namespace' => 'Drupal\\Core\\Database\\Driver\\mysql',
  13 +# 'password' => getenv('MYSQL_PASSWORD'),
  14 +# 'port' => getenv('MYSQL_PORT'),
  15 +# 'prefix' => '',
  16 +# 'username' => getenv('MYSQL_USER'),
  17 +# ];
  18 +#
  19 +# Uncomment and populate as needed.
  20 +# MYSQL_DATABASE=
  21 +# MYSQL_HOSTNAME=
  22 +# MYSQL_PASSWORD=
  23 +# MYSQL_PORT=
  24 +# MYSQL_USER=
  25 +
  26 +# Another common use case is to set Drush's --uri via environment.
  27 +# DRUSH_OPTIONS_URI=http://example.com
... ...
  1 +# Ignore directories generated by Composer
  2 +/drush/contrib/
  3 +/vendor/
  4 +/web/core/
  5 +/web/modules/contrib/
  6 +/web/themes/contrib/
  7 +/web/profiles/contrib/
  8 +/web/libraries/
  9 +
  10 +# Ignore sensitive information
  11 +/web/sites/*/settings.php
  12 +/web/sites/*/settings.local.php
  13 +
  14 +# Ignore Drupal's file directory
  15 +/web/sites/*/files/
  16 +
  17 +# Ignore SimpleTest multi-site environment.
  18 +/web/sites/simpletest
  19 +
  20 +# Ignore files generated by PhpStorm
  21 +/.idea/
  22 +
  23 +# Ignore .env files as they are personal
  24 +/.env
... ...
  1 +language: php
  2 +dist: trusty
  3 +sudo: false
  4 +
  5 +php:
  6 + - 5.6
  7 + - 7.0
  8 + - 7.1
  9 + - 7.2
  10 +
  11 +env:
  12 + global:
  13 + - SIMPLETEST_DB=sqlite://tmp/site.sqlite
  14 + - SIMPLETEST_BASE_URL="http://127.0.0.1:8080"
  15 + matrix:
  16 + - RELEASE=stable COMPOSER_CHANNEL=stable
  17 + - RELEASE=dev COMPOSER_CHANNEL=stable
  18 + - RELEASE=stable COMPOSER_CHANNEL=snapshot
  19 +
  20 +matrix:
  21 + exclude:
  22 + - php: 7.2
  23 + env: RELEASE=stable COMPOSER_CHANNEL=stable
  24 + - php: 7.2
  25 + env: RELEASE=stable COMPOSER_CHANNEL=snapshot
  26 +
  27 +before_install:
  28 + - echo 'sendmail_path = /bin/true' >> ~/.phpenv/versions/$(phpenv version-name)/etc/conf.d/travis.ini
  29 + - phpenv config-rm xdebug.ini
  30 + - composer --verbose self-update --$COMPOSER_CHANNEL
  31 + - composer --version
  32 +
  33 +install:
  34 + - composer --verbose validate
  35 + - composer --verbose install
  36 +
  37 +script:
  38 + - if [[ $RELEASE = dev ]]; then composer --verbose remove --no-update drupal/console; fi;
  39 + - if [[ $RELEASE = dev ]]; then composer --verbose require --no-update drupal/core:8.6.x-dev webflo/drupal-core-require-dev:8.6.x-dev; fi;
  40 + - if [[ $RELEASE = dev ]]; then composer --verbose update; fi;
  41 + - cd $TRAVIS_BUILD_DIR/web
  42 + - ./../vendor/bin/drush site-install --verbose --yes --db-url=sqlite://tmp/site.sqlite
  43 + - ./../vendor/bin/drush runserver $SIMPLETEST_BASE_URL &
  44 + - until curl -s $SIMPLETEST_BASE_URL; do true; done > /dev/null
  45 + # Skip core/tests/Drupal/Tests/ComposerIntegrationTest.php because web/ has no composer.json
  46 + # Ignore PageCache group temporarily, @see https://www.drupal.org/node/2770673
  47 + - ./../vendor/bin/phpunit -c core --testsuite unit --exclude-group Composer,DependencyInjection,PageCache
  48 + - ./../vendor/bin/drush
  49 + - if [[ $RELEASE = stable ]]; then ./../vendor/bin/drupal; fi;
... ...
  1 + GNU GENERAL PUBLIC LICENSE
  2 + Version 2, June 1991
  3 +
  4 + Copyright (C) 1989, 1991 Free Software Foundation, Inc., <http://fsf.org/>
  5 + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  6 + Everyone is permitted to copy and distribute verbatim copies
  7 + of this license document, but changing it is not allowed.
  8 +
  9 + Preamble
  10 +
  11 + The licenses for most software are designed to take away your
  12 +freedom to share and change it. By contrast, the GNU General Public
  13 +License is intended to guarantee your freedom to share and change free
  14 +software--to make sure the software is free for all its users. This
  15 +General Public License applies to most of the Free Software
  16 +Foundation's software and to any other program whose authors commit to
  17 +using it. (Some other Free Software Foundation software is covered by
  18 +the GNU Lesser General Public License instead.) You can apply it to
  19 +your programs, too.
  20 +
  21 + When we speak of free software, we are referring to freedom, not
  22 +price. Our General Public Licenses are designed to make sure that you
  23 +have the freedom to distribute copies of free software (and charge for
  24 +this service if you wish), that you receive source code or can get it
  25 +if you want it, that you can change the software or use pieces of it
  26 +in new free programs; and that you know you can do these things.
  27 +
  28 + To protect your rights, we need to make restrictions that forbid
  29 +anyone to deny you these rights or to ask you to surrender the rights.
  30 +These restrictions translate to certain responsibilities for you if you
  31 +distribute copies of the software, or if you modify it.
  32 +
  33 + For example, if you distribute copies of such a program, whether
  34 +gratis or for a fee, you must give the recipients all the rights that
  35 +you have. You must make sure that they, too, receive or can get the
  36 +source code. And you must show them these terms so they know their
  37 +rights.
  38 +
  39 + We protect your rights with two steps: (1) copyright the software, and
  40 +(2) offer you this license which gives you legal permission to copy,
  41 +distribute and/or modify the software.
  42 +
  43 + Also, for each author's protection and ours, we want to make certain
  44 +that everyone understands that there is no warranty for this free
  45 +software. If the software is modified by someone else and passed on, we
  46 +want its recipients to know that what they have is not the original, so
  47 +that any problems introduced by others will not reflect on the original
  48 +authors' reputations.
  49 +
  50 + Finally, any free program is threatened constantly by software
  51 +patents. We wish to avoid the danger that redistributors of a free
  52 +program will individually obtain patent licenses, in effect making the
  53 +program proprietary. To prevent this, we have made it clear that any
  54 +patent must be licensed for everyone's free use or not licensed at all.
  55 +
  56 + The precise terms and conditions for copying, distribution and
  57 +modification follow.
  58 +
  59 + GNU GENERAL PUBLIC LICENSE
  60 + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
  61 +
  62 + 0. This License applies to any program or other work which contains
  63 +a notice placed by the copyright holder saying it may be distributed
  64 +under the terms of this General Public License. The "Program", below,
  65 +refers to any such program or work, and a "work based on the Program"
  66 +means either the Program or any derivative work under copyright law:
  67 +that is to say, a work containing the Program or a portion of it,
  68 +either verbatim or with modifications and/or translated into another
  69 +language. (Hereinafter, translation is included without limitation in
  70 +the term "modification".) Each licensee is addressed as "you".
  71 +
  72 +Activities other than copying, distribution and modification are not
  73 +covered by this License; they are outside its scope. The act of
  74 +running the Program is not restricted, and the output from the Program
  75 +is covered only if its contents constitute a work based on the
  76 +Program (independent of having been made by running the Program).
  77 +Whether that is true depends on what the Program does.
  78 +
  79 + 1. You may copy and distribute verbatim copies of the Program's
  80 +source code as you receive it, in any medium, provided that you
  81 +conspicuously and appropriately publish on each copy an appropriate
  82 +copyright notice and disclaimer of warranty; keep intact all the
  83 +notices that refer to this License and to the absence of any warranty;
  84 +and give any other recipients of the Program a copy of this License
  85 +along with the Program.
  86 +
  87 +You may charge a fee for the physical act of transferring a copy, and
  88 +you may at your option offer warranty protection in exchange for a fee.
  89 +
  90 + 2. You may modify your copy or copies of the Program or any portion
  91 +of it, thus forming a work based on the Program, and copy and
  92 +distribute such modifications or work under the terms of Section 1
  93 +above, provided that you also meet all of these conditions:
  94 +
  95 + a) You must cause the modified files to carry prominent notices
  96 + stating that you changed the files and the date of any change.
  97 +
  98 + b) You must cause any work that you distribute or publish, that in
  99 + whole or in part contains or is derived from the Program or any
  100 + part thereof, to be licensed as a whole at no charge to all third
  101 + parties under the terms of this License.
  102 +
  103 + c) If the modified program normally reads commands interactively
  104 + when run, you must cause it, when started running for such
  105 + interactive use in the most ordinary way, to print or display an
  106 + announcement including an appropriate copyright notice and a
  107 + notice that there is no warranty (or else, saying that you provide
  108 + a warranty) and that users may redistribute the program under
  109 + these conditions, and telling the user how to view a copy of this
  110 + License. (Exception: if the Program itself is interactive but
  111 + does not normally print such an announcement, your work based on
  112 + the Program is not required to print an announcement.)
  113 +
  114 +These requirements apply to the modified work as a whole. If
  115 +identifiable sections of that work are not derived from the Program,
  116 +and can be reasonably considered independent and separate works in
  117 +themselves, then this License, and its terms, do not apply to those
  118 +sections when you distribute them as separate works. But when you
  119 +distribute the same sections as part of a whole which is a work based
  120 +on the Program, the distribution of the whole must be on the terms of
  121 +this License, whose permissions for other licensees extend to the
  122 +entire whole, and thus to each and every part regardless of who wrote it.
  123 +
  124 +Thus, it is not the intent of this section to claim rights or contest
  125 +your rights to work written entirely by you; rather, the intent is to
  126 +exercise the right to control the distribution of derivative or
  127 +collective works based on the Program.
  128 +
  129 +In addition, mere aggregation of another work not based on the Program
  130 +with the Program (or with a work based on the Program) on a volume of
  131 +a storage or distribution medium does not bring the other work under
  132 +the scope of this License.
  133 +
  134 + 3. You may copy and distribute the Program (or a work based on it,
  135 +under Section 2) in object code or executable form under the terms of
  136 +Sections 1 and 2 above provided that you also do one of the following:
  137 +
  138 + a) Accompany it with the complete corresponding machine-readable
  139 + source code, which must be distributed under the terms of Sections
  140 + 1 and 2 above on a medium customarily used for software interchange; or,
  141 +
  142 + b) Accompany it with a written offer, valid for at least three
  143 + years, to give any third party, for a charge no more than your
  144 + cost of physically performing source distribution, a complete
  145 + machine-readable copy of the corresponding source code, to be
  146 + distributed under the terms of Sections 1 and 2 above on a medium
  147 + customarily used for software interchange; or,
  148 +
  149 + c) Accompany it with the information you received as to the offer
  150 + to distribute corresponding source code. (This alternative is
  151 + allowed only for noncommercial distribution and only if you
  152 + received the program in object code or executable form with such
  153 + an offer, in accord with Subsection b above.)
  154 +
  155 +The source code for a work means the preferred form of the work for
  156 +making modifications to it. For an executable work, complete source
  157 +code means all the source code for all modules it contains, plus any
  158 +associated interface definition files, plus the scripts used to
  159 +control compilation and installation of the executable. However, as a
  160 +special exception, the source code distributed need not include
  161 +anything that is normally distributed (in either source or binary
  162 +form) with the major components (compiler, kernel, and so on) of the
  163 +operating system on which the executable runs, unless that component
  164 +itself accompanies the executable.
  165 +
  166 +If distribution of executable or object code is made by offering
  167 +access to copy from a designated place, then offering equivalent
  168 +access to copy the source code from the same place counts as
  169 +distribution of the source code, even though third parties are not
  170 +compelled to copy the source along with the object code.
  171 +
  172 + 4. You may not copy, modify, sublicense, or distribute the Program
  173 +except as expressly provided under this License. Any attempt
  174 +otherwise to copy, modify, sublicense or distribute the Program is
  175 +void, and will automatically terminate your rights under this License.
  176 +However, parties who have received copies, or rights, from you under
  177 +this License will not have their licenses terminated so long as such
  178 +parties remain in full compliance.
  179 +
  180 + 5. You are not required to accept this License, since you have not
  181 +signed it. However, nothing else grants you permission to modify or
  182 +distribute the Program or its derivative works. These actions are
  183 +prohibited by law if you do not accept this License. Therefore, by
  184 +modifying or distributing the Program (or any work based on the
  185 +Program), you indicate your acceptance of this License to do so, and
  186 +all its terms and conditions for copying, distributing or modifying
  187 +the Program or works based on it.
  188 +
  189 + 6. Each time you redistribute the Program (or any work based on the
  190 +Program), the recipient automatically receives a license from the
  191 +original licensor to copy, distribute or modify the Program subject to
  192 +these terms and conditions. You may not impose any further
  193 +restrictions on the recipients' exercise of the rights granted herein.
  194 +You are not responsible for enforcing compliance by third parties to
  195 +this License.
  196 +
  197 + 7. If, as a consequence of a court judgment or allegation of patent
  198 +infringement or for any other reason (not limited to patent issues),
  199 +conditions are imposed on you (whether by court order, agreement or
  200 +otherwise) that contradict the conditions of this License, they do not
  201 +excuse you from the conditions of this License. If you cannot
  202 +distribute so as to satisfy simultaneously your obligations under this
  203 +License and any other pertinent obligations, then as a consequence you
  204 +may not distribute the Program at all. For example, if a patent
  205 +license would not permit royalty-free redistribution of the Program by
  206 +all those who receive copies directly or indirectly through you, then
  207 +the only way you could satisfy both it and this License would be to
  208 +refrain entirely from distribution of the Program.
  209 +
  210 +If any portion of this section is held invalid or unenforceable under
  211 +any particular circumstance, the balance of the section is intended to
  212 +apply and the section as a whole is intended to apply in other
  213 +circumstances.
  214 +
  215 +It is not the purpose of this section to induce you to infringe any
  216 +patents or other property right claims or to contest validity of any
  217 +such claims; this section has the sole purpose of protecting the
  218 +integrity of the free software distribution system, which is
  219 +implemented by public license practices. Many people have made
  220 +generous contributions to the wide range of software distributed
  221 +through that system in reliance on consistent application of that
  222 +system; it is up to the author/donor to decide if he or she is willing
  223 +to distribute software through any other system and a licensee cannot
  224 +impose that choice.
  225 +
  226 +This section is intended to make thoroughly clear what is believed to
  227 +be a consequence of the rest of this License.
  228 +
  229 + 8. If the distribution and/or use of the Program is restricted in
  230 +certain countries either by patents or by copyrighted interfaces, the
  231 +original copyright holder who places the Program under this License
  232 +may add an explicit geographical distribution limitation excluding
  233 +those countries, so that distribution is permitted only in or among
  234 +countries not thus excluded. In such case, this License incorporates
  235 +the limitation as if written in the body of this License.
  236 +
  237 + 9. The Free Software Foundation may publish revised and/or new versions
  238 +of the General Public License from time to time. Such new versions will
  239 +be similar in spirit to the present version, but may differ in detail to
  240 +address new problems or concerns.
  241 +
  242 +Each version is given a distinguishing version number. If the Program
  243 +specifies a version number of this License which applies to it and "any
  244 +later version", you have the option of following the terms and conditions
  245 +either of that version or of any later version published by the Free
  246 +Software Foundation. If the Program does not specify a version number of
  247 +this License, you may choose any version ever published by the Free Software
  248 +Foundation.
  249 +
  250 + 10. If you wish to incorporate parts of the Program into other free
  251 +programs whose distribution conditions are different, write to the author
  252 +to ask for permission. For software which is copyrighted by the Free
  253 +Software Foundation, write to the Free Software Foundation; we sometimes
  254 +make exceptions for this. Our decision will be guided by the two goals
  255 +of preserving the free status of all derivatives of our free software and
  256 +of promoting the sharing and reuse of software generally.
  257 +
  258 + NO WARRANTY
  259 +
  260 + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
  261 +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
  262 +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
  263 +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  264 +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  265 +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
  266 +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
  267 +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
  268 +REPAIR OR CORRECTION.
  269 +
  270 + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  271 +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
  272 +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
  273 +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  274 +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
  275 +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
  276 +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  277 +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  278 +POSSIBILITY OF SUCH DAMAGES.
  279 +
  280 + END OF TERMS AND CONDITIONS
  281 +
  282 + How to Apply These Terms to Your New Programs
  283 +
  284 + If you develop a new program, and you want it to be of the greatest
  285 +possible use to the public, the best way to achieve this is to make it
  286 +free software which everyone can redistribute and change under these terms.
  287 +
  288 + To do so, attach the following notices to the program. It is safest
  289 +to attach them to the start of each source file to most effectively
  290 +convey the exclusion of warranty; and each file should have at least
  291 +the "copyright" line and a pointer to where the full notice is found.
  292 +
  293 + {description}
  294 + Copyright (C) {year} {fullname}
  295 +
  296 + This program is free software; you can redistribute it and/or modify
  297 + it under the terms of the GNU General Public License as published by
  298 + the Free Software Foundation; either version 2 of the License, or
  299 + (at your option) any later version.
  300 +
  301 + This program is distributed in the hope that it will be useful,
  302 + but WITHOUT ANY WARRANTY; without even the implied warranty of
  303 + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  304 + GNU General Public License for more details.
  305 +
  306 + You should have received a copy of the GNU General Public License along
  307 + with this program; if not, write to the Free Software Foundation, Inc.,
  308 + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  309 +
  310 +Also add information on how to contact you by electronic and paper mail.
  311 +
  312 +If the program is interactive, make it output a short notice like this
  313 +when it starts in an interactive mode:
  314 +
  315 + Gnomovision version 69, Copyright (C) year name of author
  316 + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
  317 + This is free software, and you are welcome to redistribute it
  318 + under certain conditions; type `show c' for details.
  319 +
  320 +The hypothetical commands `show w' and `show c' should show the appropriate
  321 +parts of the General Public License. Of course, the commands you use may
  322 +be called something other than `show w' and `show c'; they could even be
  323 +mouse-clicks or menu items--whatever suits your program.
  324 +
  325 +You should also get your employer (if you work as a programmer) or your
  326 +school, if any, to sign a "copyright disclaimer" for the program, if
  327 +necessary. Here is a sample; alter the names:
  328 +
  329 + Yoyodyne, Inc., hereby disclaims all copyright interest in the program
  330 + `Gnomovision' (which makes passes at compilers) written by James Hacker.
  331 +
  332 + {signature of Ty Coon}, 1 April 1989
  333 + Ty Coon, President of Vice
  334 +
  335 +This General Public License does not permit incorporating your program into
  336 +proprietary programs. If your program is a subroutine library, you may
  337 +consider it more useful to permit linking proprietary applications with the
  338 +library. If this is what you want to do, use the GNU Lesser General
  339 +Public License instead of this License.
... ...
  1 +# Composer template for Drupal projects
  2 +
  3 +[![Build Status](https://travis-ci.org/drupal-composer/drupal-project.svg?branch=8.x)](https://travis-ci.org/drupal-composer/drupal-project)
  4 +
  5 +This project template provides a starter kit for managing your site
  6 +dependencies with [Composer](https://getcomposer.org/).
  7 +
  8 +If you want to know how to use it as replacement for
  9 +[Drush Make](https://github.com/drush-ops/drush/blob/8.x/docs/make.md) visit
  10 +the [Documentation on drupal.org](https://www.drupal.org/node/2471553).
  11 +
  12 +## Usage
  13 +
  14 +First you need to [install composer](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx).
  15 +
  16 +> Note: The instructions below refer to the [global composer installation](https://getcomposer.org/doc/00-intro.md#globally).
  17 +You might need to replace `composer` with `php composer.phar` (or similar)
  18 +for your setup.
  19 +
  20 +After that you can create the project:
  21 +
  22 +```
  23 +composer create-project drupal-composer/drupal-project:8.x-dev some-dir --stability dev --no-interaction
  24 +```
  25 +
  26 +With `composer require ...` you can download new dependencies to your
  27 +installation.
  28 +
  29 +```
  30 +cd some-dir
  31 +composer require drupal/devel:~1.0
  32 +```
  33 +
  34 +The `composer create-project` command passes ownership of all files to the
  35 +project that is created. You should create a new git repository, and commit
  36 +all files not excluded by the .gitignore file.
  37 +
  38 +## What does the template do?
  39 +
  40 +When installing the given `composer.json` some tasks are taken care of:
  41 +
  42 +* Drupal will be installed in the `web`-directory.
  43 +* Autoloader is implemented to use the generated composer autoloader in `vendor/autoload.php`,
  44 + instead of the one provided by Drupal (`web/vendor/autoload.php`).
  45 +* Modules (packages of type `drupal-module`) will be placed in `web/modules/contrib/`
  46 +* Theme (packages of type `drupal-theme`) will be placed in `web/themes/contrib/`
  47 +* Profiles (packages of type `drupal-profile`) will be placed in `web/profiles/contrib/`
  48 +* Creates default writable versions of `settings.php` and `services.yml`.
  49 +* Creates `web/sites/default/files`-directory.
  50 +* Latest version of drush is installed locally for use at `vendor/bin/drush`.
  51 +* Latest version of DrupalConsole is installed locally for use at `vendor/bin/drupal`.
  52 +* Creates environment variables based on your .env file. See [.env.example](.env.example).
  53 +
  54 +## Updating Drupal Core
  55 +
  56 +This project will attempt to keep all of your Drupal Core files up-to-date; the
  57 +project [drupal-composer/drupal-scaffold](https://github.com/drupal-composer/drupal-scaffold)
  58 +is used to ensure that your scaffold files are updated every time drupal/core is
  59 +updated. If you customize any of the "scaffolding" files (commonly .htaccess),
  60 +you may need to merge conflicts if any of your modified files are updated in a
  61 +new release of Drupal core.
  62 +
  63 +Follow the steps below to update your core files.
  64 +
  65 +1. Run `composer update drupal/core webflo/drupal-core-require-dev symfony/* --with-dependencies` to update Drupal Core and its dependencies.
  66 +1. Run `git diff` to determine if any of the scaffolding files have changed.
  67 + Review the files for any changes and restore any customizations to
  68 + `.htaccess` or `robots.txt`.
  69 +1. Commit everything all together in a single commit, so `web` will remain in
  70 + sync with the `core` when checking out branches or running `git bisect`.
  71 +1. In the event that there are non-trivial conflicts in step 2, you may wish
  72 + to perform these steps on a branch, and use `git merge` to combine the
  73 + updated core files with your customized files. This facilitates the use
  74 + of a [three-way merge tool such as kdiff3](http://www.gitshah.com/2010/12/how-to-setup-kdiff-as-diff-tool-for-git.html). This setup is not necessary if your changes are simple;
  75 + keeping all of your modifications at the beginning or end of the file is a
  76 + good strategy to keep merges easy.
  77 +
  78 +## Generate composer.json from existing project
  79 +
  80 +With using [the "Composer Generate" drush extension](https://www.drupal.org/project/composer_generate)
  81 +you can now generate a basic `composer.json` file from an existing project. Note
  82 +that the generated `composer.json` might differ from this project's file.
  83 +
  84 +
  85 +## FAQ
  86 +
  87 +### Should I commit the contrib modules I download?
  88 +
  89 +Composer recommends **no**. They provide [argumentation against but also
  90 +workrounds if a project decides to do it anyway](https://getcomposer.org/doc/faqs/should-i-commit-the-dependencies-in-my-vendor-directory.md).
  91 +
  92 +### Should I commit the scaffolding files?
  93 +
  94 +The [drupal-scaffold](https://github.com/drupal-composer/drupal-scaffold) plugin can download the scaffold files (like
  95 +index.php, update.php, …) to the web/ directory of your project. If you have not customized those files you could choose
  96 +to not check them into your version control system (e.g. git). If that is the case for your project it might be
  97 +convenient to automatically run the drupal-scaffold plugin after every install or update of your project. You can
  98 +achieve that by registering `@drupal-scaffold` as post-install and post-update command in your composer.json:
  99 +
  100 +```json
  101 +"scripts": {
  102 + "drupal-scaffold": "DrupalComposer\\DrupalScaffold\\Plugin::scaffold",
  103 + "post-install-cmd": [
  104 + "@drupal-scaffold",
  105 + "..."
  106 + ],
  107 + "post-update-cmd": [
  108 + "@drupal-scaffold",
  109 + "..."
  110 + ]
  111 +},
  112 +```
  113 +### How can I apply patches to downloaded modules?
  114 +
  115 +If you need to apply patches (depending on the project being modified, a pull
  116 +request is often a better solution), you can do so with the
  117 +[composer-patches](https://github.com/cweagans/composer-patches) plugin.
  118 +
  119 +To add a patch to drupal module foobar insert the patches section in the extra
  120 +section of composer.json:
  121 +```json
  122 +"extra": {
  123 + "patches": {
  124 + "drupal/foobar": {
  125 + "Patch description": "URL or local path to patch"
  126 + }
  127 + }
  128 +}
  129 +```
  130 +### How do I switch from packagist.drupal-composer.org to packages.drupal.org?
  131 +
  132 +Follow the instructions in the [documentation on drupal.org](https://www.drupal.org/docs/develop/using-composer/using-packagesdrupalorg).
  133 +
  134 +### How do I specify a PHP version ?
  135 +
  136 +Currently Drupal 8 supports PHP 5.5.9 as minimum version (see [Drupal 8 PHP requirements](https://www.drupal.org/docs/8/system-requirements/drupal-8-php-requirements)), however it's possible that a `composer update` will upgrade some package that will then require PHP 7+.
  137 +
  138 +To prevent this you can add this code to specify the PHP version you want to use in the `config` section of `composer.json`:
  139 +```json
  140 +"config": {
  141 + "sort-packages": true,
  142 + "platform": {"php": "5.5.9"}
  143 +},
  144 +```
... ...
  1 +{
  2 + "name": "drupal-composer/drupal-project",
  3 + "description": "Project template for Drupal 8 projects with composer",
  4 + "type": "project",
  5 + "license": "GPL-2.0-or-later",
  6 + "authors": [
  7 + {
  8 + "name": "",
  9 + "role": ""
  10 + }
  11 + ],
  12 + "repositories": [
  13 + {
  14 + "type": "composer",
  15 + "url": "https://packages.drupal.org/8"
  16 + }
  17 + ],
  18 + "require": {
  19 + "composer/installers": "^1.2",
  20 + "cweagans/composer-patches": "^1.6",
  21 + "drupal-composer/drupal-scaffold": "^2.2",
  22 + "drupal/console": "^1.0.2",
  23 + "drupal/core": "~8.5.3",
  24 + "vlucas/phpdotenv": "^2.4",
  25 + "webflo/drupal-finder": "^1.0.0",
  26 + "webmozart/path-util": "^2.3"
  27 + },
  28 + "require-dev": {
  29 + "webflo/drupal-core-require-dev": "~8.5.3"
  30 + },
  31 + "conflict": {
  32 + "drupal/drupal": "*"
  33 + },
  34 + "minimum-stability": "dev",
  35 + "prefer-stable": true,
  36 + "config": {
  37 + "sort-packages": true
  38 + },
  39 + "autoload": {
  40 + "classmap": [
  41 + "scripts/composer/ScriptHandler.php"
  42 + ],
  43 + "files": ["load.environment.php"]
  44 + },
  45 + "scripts": {
  46 + "drupal-scaffold": "DrupalComposer\\DrupalScaffold\\Plugin::scaffold",
  47 + "pre-install-cmd": [
  48 + "DrupalProject\\composer\\ScriptHandler::checkComposerVersion"
  49 + ],
  50 + "pre-update-cmd": [
  51 + "DrupalProject\\composer\\ScriptHandler::checkComposerVersion"
  52 + ],
  53 + "post-install-cmd": [
  54 + "DrupalProject\\composer\\ScriptHandler::createRequiredFiles"
  55 + ],
  56 + "post-update-cmd": [
  57 + "DrupalProject\\composer\\ScriptHandler::createRequiredFiles"
  58 + ]
  59 + },
  60 + "extra": {
  61 + "installer-paths": {
  62 + "web/core": ["type:drupal-core"],
  63 + "web/libraries/{$name}": ["type:drupal-library"],
  64 + "web/modules/contrib/{$name}": ["type:drupal-module"],
  65 + "web/profiles/contrib/{$name}": ["type:drupal-profile"],
  66 + "web/themes/contrib/{$name}": ["type:drupal-theme"],
  67 + "drush/contrib/{$name}": ["type:drupal-drush"]
  68 + }
  69 + }
  70 +}
... ...
Please register or login to post a comment