Support for PHP 7.2 is here!
For all who doesn't know about new type of versions of Nette Framewor 2.4,
there is no planed 2.4.x version. All packages have their maintenance version,
but Framework doesn’t have. There is build
from (2017–08–29) with release notes, that is full compatible with
incomming PHP version 7.2
We spent summer together at an extraordinary meeting Nette Camp and two excursions to Czech
breweries. Definitely follow up the events next year. It's an interesting way
to meet in an offline world. In September, the
90th anniversary Last Saturday is waiting for us.
In a Nutshell
Contribute — Minimalistic integration of Symfony/Console to Nette
application contributte/console
Nextras — datagrid v 3.0.0rc nextras/datagrid/releases/tag/v3.0.0-rc2
Nextras — migration v3.0.5 & v3.1rc nextras/migrations/releases/tag/v3.0.5
PeckaDesign — asynchronous components github.com/peckadesign/AsyncControl
Nas — a component for nested selectbox NasExt/DependentSelectBox
In Conclusion
Thanks to partner of edition: www.tajnyprojekt.cz
If you have ideas how to improve our next edition, please let me know. Have
I forgotten something? Make sure to email me and we will include it in the next
edition. We are still looking for partners who wish to address the growing
community interested in our news.
Honza Cerny
How to get rid of PhpStorm alerts on “undefined fields” and activate the
code completion for $this->template in presenters?
So how to change this view with the underlined abc and the empty
pop-up window:
Into this?
Simply. Just add the following annotation to the presenter (for example to
BasePresenter):
abstract class BasePresenter extends Nette\Application\UI\Presenter
Note: In the latest versions of Nette, this annotation will be directly in the
code.
Template class
The stdClass class in the annotation is a workaround for
PhpStorm, which otherwise treats all variables as undefined. However, it is more
interesting to create a class with a real list of the variables that the
template uses, including their types. It may look like this:
class ArticleTemplate
{
public $lang;
public $page;
public $menu;
public $article;
}
And then put it in the annotation of a specific presenter instead of
stdClass:
final class ArticlePresenter extends Nette\Application\UI\Presenter
From now on, the message is perfect:
We still have to solve the suggestion in the template. So far, Latte plugin can't do
it, but once it can, it could use the same template class. For example, there
could be a new macro {template App\Presenters\ArticleTemplate} that
will pass the template class name.
Nette Tester 2 is finally out. I'll describe changes and new features in
detail.
Compatibility
New Tester requires PHP in version 5.6 or newer and supports PHP
7.2. Simultaneously, support for HHVM has been dropped. There has been small opinion
poll on this topic.
Changes in tests runner
Tester's default interpreter (when called without the -p
option) is CLI now. It used to be CGI. You will see notice in console
about it.
When you pass directory as a tester argument, it will find all
*.phpt files as usual, but newly it will find all
*Test.php files additionally.
The Tester used to run tests in order as they have been found. Now, it will
run last time failing tests as first. For this purpose, the Tester uses
temporary directory. Default is got by sys_get_temp_dir() and you
can change it by explicit --temp <path> option. The
--info call will help you find out currently used directory. Try to
think about this new feature in relation to --stop-on-fail or
--watch options. It may improve your workflow.
As mentioned in documentation, every test is run by PHP in separated process
with -n option. So without php.ini file. Sometimes it is painful to
tune up own php.ini file for tests. A new option -C is introduced,
it causes that -n is not used and as a consequence, tests run with
system-wide PHP settings.
Sometimes is good to know whether test is running by
tester myTest.phpt or as an ordinary PHP script by
php myTest.phpt. An environment variable will help you to
recognize it:
if (getenv(Tester\Environment::RUNNER)) {
} else {
}
And when talking about environment variables, there is another one. When
tests run in parallel, by default in 8 threads, you can be interested in a
current thread number.
$threadNumber = getenv(Tester\Environment::THREAD);
Changes in testing framework
New modifiers for Assert::match() have been added. The
%w% matches alphanumeric chars 0-9, a-z,
A-Z and _ (underscore). The %% matches
one % char.
Behavior of FileMock has been fixed, mainly in an
append mode.
Another change concerns the TestCase. Now, the
TestCase::tearDown() run always, even aften an error occurred in a
testing method. Small BC break is that the TestCase::run() method
does not accept arguments anymore. If you need to run a single testing method,
use the TestCase::runTest($method, array $args = []) method.
New test file annotation @phpExtension has been added. When some
of given extensions is not loaded, test will be skipped. You can use one
annotation with multiple extensions, or split it to multiple annotations. For
example:
Completely new helper FileMutator has been added. Its purpose is
to adjust source code of loaded files. The first real use case is removing
final keyword from classes and class methods. Usage is simple. Call
the Tester\Environment::bypassFinals() on the very top of a test
file, it will setup FileMutator for you.
require 'bootstrap.php';
Tester\Environment::bypassFinals();
When other than expected exception is thrown in the
Assert::exception(), its stack trace will be printed. It helps to
find out, what is wrong.
If you are using Assert::match() with modifiers
(%a%, %d% and so on), you will be pleasured by a new
feature. In case of fail, modifiers are replaced by their matching values in
output and dumps. An example will say more. Imagine test such:
$tested = "My name is Milo and I'm -65535 years old.";
Assert::match("My name is %S% and I'm %d% years old.", $tested);
# An output before the Tester 2
Failed: 'My name is Milo and I'm -65535 years old.' should match
... 'My name is %S% and I'm %d% years old.'
# An output with new Tester
Failed: 'My name is Milo and I'm -65535 years old.' should match
... 'My name is Milo and I'm %d% years old.'
Do you see that small difference? The %S% modifier is now
replaced by a matching value and you don't need to decrypt where mismatch
occurred. Very handy when matching long strings.
If you use code coverage functionality with a PHPDBG, some tests may fail due
to a memory exhaustion. Coverage data collecting is a memory consuming
operation. You can increase memory limits, or you can call
Tester\CodeCoverage\Collector::flush(). It will write collected
data into file and release occupied memory. Calling has no effect with Xdebug or
when collecting is not running at all.
HTML output of code coverage has been facelifted. Check out an example.
And here we come with the biggest BC break in the Tester 2. Changes in the
OutputHandler interface. Before I'll describe it, I have to make a
short introduction how tests are handled internally by the Tester.
Inside the Tester, single test is represented by Test
class instance. In a short, it contains test file path, test title, result
code, captured standard output and so on. Check out the source code for details.
These instances are passed to output handlers in the Tester 2. Refactored OutputHandler
now looks as follows:
namespace Tester\Runner;
interface OutputHandler
{
function begin();
function prepare(Test $test);
function finish(Test $test);
function end();
}
Some other minor improvements have been done, like printing code coverage
percent value into console, or dumping arrays in a short syntax.
In conclusion
The Tester's internal code went through more changes, but they are not
important for end users. For example, Tester's code base now uses new Nette
coding style with small true, false, null
constants and use new code checker. Details can be found in commits history.
Documentation is up to date and is still on the same place as usual.
Many thanks to all contributors! Enjoy the new release!
New Nette 2.4 is out
After a summer break, here comes a whole heap of news and info about what has
been going on and what is in the picture. The hottest piece of news is the new
version of Nette Framework 2.4. A complex overview of changes made to the
framework, including all novelties related to versioning, can be found on the
release webpage: https://forum.nette.org/…2-4-released.
In short, in the future only respective packages will be versioned (such as the
release described here: https://forum.nette.org/…4-2016-07-31).
Other big changes that should be mentioned is Nette/Object replacement with
traits, see David's talk from Hradec Králové: https://www.youtube.com/watch?…
and the fact the “guts” of Latte, a template system, have been rewritten (a
video from Plzeň will be published on YouTube soon). Here is also a post
bringing attention to what you need to be careful about when migrating: https://forum.nette.org/…nette-2-4-rc.
If you're still unsure whether you should use the latest version of Nette
Framework or not, why don't you read a short post from the Slevomat boys about
changin to 2.4: https://twitter.com/…122388672512,
there are more and more companies following the example. In case you run on
2.4 too, tweet with hashtag #nettefw.
Nette Camp
A four-day event filled with Nette and beer took place in a quaint village
in Czech Paradise and judging from the reactions, it was a hit. Speaking on
behalf of organisers, we have learnt yet a lot and let's hope it will be for
the benefit of future events. You can expect Nette Camp 2017 again in the last
two weeks of August. As a surprise we migrated addons.nette.org to a new portal:
https://componette.com .
pehapkari.cz
Following several meetings with Tomáš Votruba, the Czech Symfony community
care-taker, we put our heads together and we are starting to build a framework
non specific php community. More news to be expected on twitter @pehapkari. Follow us for what's hot
in the czech php world. We started to broadcast a podcast too! : http://nejenophp.cz
In a Nutshell
Compatible extensions releases go hand in hand with the release of new Nette
Framework version. Most packages are compatible with Nette 2.4 already, if
sometimes in @dev versions for now. We are still waiting for some stable
releases.
Profiler
Petr Knap from Netpromotion released a simple PHP profiler with a Tracy
extension: https://github.com/…ion/profiler
Nette and Webpack
Jirka Pudil wrote an article on how to interlink these two platforms in an
easy way: https://jiripudil.cz/…with-webpack
In Conclusion
If you have ideas how to improve our next edition, please let me know. Have
I forgotten something? Make sure to email me and we will include it in the next
edition. We are still looking for partners who wish to address the growing
community interested in our news.
Honza Cerny
P.S.: David released a new framework version ready to support php 7.1 while
I was writing my intro: https://forum.nette.org/…4-2016-09-30
Nette 2.4 is coming closer
At the last PoSobota meetup, David Grudl introduced the news waiting for us
in the version 2.4 which should become the LTS in Nette version 2. There are
big plans with Nette version 3, especially regarding PHP 7, therefore the
version 2.4 should most likely be the version for all Nette 2.x projects to
stick to for good, thus the prolonged support. As of today, the minimal support
of each .x version is 2 years, prolonged by at least a year in the LTS
version.
Nette Camp
Summer is coming! (pun intended) and the planned outing in the open is coming
with it. You can pre-register at www.nettecamp.cz. Together with Tomas Jacik,
we are preparing many new things and we will try to overcome the obstacles
exposed by last year’s 0th Camp. The date is 25 – 28 August 2016 and we
are moving the venue to Český ráj.
Briefly…
Nittro
Dan Kadera is actively working on Nittro, a JavaScript framework for Nette
Framework. Among new components, there is: Paginator, AutoConfirm or Dropzone.
Make sure to follow @nittrojs for upcoming demos. https://www.nittro.org/
VS Code
If you are coding in VS Code, you will surely be pleased with syntax support
for Latte and NEON. https://marketplace.visualstudio.com/items?…
Viktor
A new version of the utility Viktor https://github.com/nella/victor was
released. The utility checks whether you have the latest version of libraries
installed with composer.
Worth reading…
Martin Zlamal published an article about replacing RobotLoader with PSR-4 in
a new Nette application. http://zlml.cz/…der-aplikace
And not only that. He also wrote an article describing how the “magical”
mapping of presenters works. http://zlml.cz/…g-presenteru
To Conclude
If you desire to leave some feedback or whether you miss some important info
here, please contact me.
Honza Černý (it’s like John Black) hello@honzacerny.com
Thanks to Rockaway
